Skip to content
Skills Library
Programming · Tool integration

stitch-setup

/stitch-setup

Step-by-step installer for the stitch-kit plugin and Stitch MCP server. Use this when setting up the plugin for the first time, diagnosing connection issues, or helping a new user get Stitch running in Claude Code or Codex CLI.

Repository
stitch-kit ↗
Licence
Apache-2.0
Last repository change
20.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
11
Deprecation

No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Step-by-step installer for the stitch-kit plugin and Stitch MCP server. Use this when setting up the plugin for the first time, diagnosing connection issues, or helping a new user get Stitch running in Claude Code or Codex CLI.

Original author description

Step-by-step installer for the stitch-kit plugin and Stitch MCP server. Use this when setting up the plugin for the first time, diagnosing connection issues, or helping a new user get Stitch running in Claude Code or Codex CLI.

How it works

  1. When to use this skill
  2. Step 1: Verify what's already installed
  3. Step 2: Get a Stitch API Key
  4. Step 3: Configure Stitch MCP
  5. Step 4: Install stitch-kit plugin (Claude Code)
  6. Step 5: Verify the full setup
  7. Troubleshooting
  8. Network requirements
  9. Offline / no-MCP mode
  10. Authentication alternatives
Original SKILL.md headings · 224 lines, 857 words
SKILL.md preview
---
name: stitch-setup
description: Step-by-step installer for the stitch-kit plugin and Stitch MCP server. Use this when setting up the plugin for the first time, diagnosing connection issues, or helping a new user get Stitch running in Claude Code or Codex CLI.
allowed-tools:
  - "Bash"
  - "Read"
  - "Write"
---

# stitch-kit Setup Guide

Walks users through two setup tasks:
1. **Stitch MCP Server** — connect your AI client to Google Stitch's remote generation API
2. **stitch-kit Plugin** — install the skills that orchestrate the Stitch workflow

---

## When to use this skill

- User says "how do I set this up", "it's not working", "Stitch isn't available"
- Agent can't find Stitch MCP tools after running `list_tools`
- First-time setup in a new environment

---

## Step 1: Verify what's already installed

Run `list_tools` (or check the tool list). Look for any of:
- `create_project`
- `generate_screen_from_text`
- `get_screen`

**If found:** Stitch MCP is working. Skip to Step 4 (plugin install).
**If not found:** Continue with MCP setup below.

---

## Step 2: Get a Stitch API Key

Stitch MCP is a **remote HTTP server** — it lives in the cloud at `stitch.googleapis.com`, not on your machine. It requires an API key to authenticate.

1. Go to [stitch.withgoogle.com/settings](https://stitch.withgoogle.com/settings)
2. Scroll to the **API Keys** section
3. Click **"Create API Key"**
4. Copy the key — you'll need it in the next step

> **Never commit your API key to a public repository.** Store it securely.

---

## Step 3: Configure Stitch MCP

### Claude Code

Using the CLI (recommended):

```bash
claude mcp add stitch --transport http https://stitch.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR-API-KEY" -s user
```

Or add to `~/.claude/settings.json` manually:

```json
{
  "mcpServers": {
    "stitch": {
      "type": "http",
      "url": "https://stitch.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR-API-KEY"
      }
    }
  }
}
```

### Codex CLI

Add to `~/.codex/config.toml`:

```toml
[mcp_servers.stitch]
url = "https://stitch.googleapis.com/mcp"

[mcp_servers.stitch.headers]
X-Goog-Api-Key = "YOUR-API-KEY"
```

### Cursor

Create or edit `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "stitch": {
      "url": "https://stitch.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR-API-KEY"
      }
    }
  }
}
```

### VS Code

Open Command Palette → "MCP: Add Server" → HTTP → `https://stitch.googleapis.com/mcp` → name: "stitch". Then edit the generated mcp.json to add the header:

```json
{
  "servers": {
    "stitch": {
      "url": "https://stitch.googleapis.com/mcp",
      "type": "http",
      "headers": {
        "Accept": "application/json",
        "X-Goog-Api-Key": "YOUR-API-KEY"
      }
    }
  }
}
```

### Quick install (all platforms)

Or use the NPX installer — it prompts for the API key and configures everything:

```bash
npx @booplex/stitch-kit
```

### Manual verification

After adding, restart the client and run `list_tools`. You should see tools like `create_project`, `generate_screen_from_text`, `get_screen`, etc.

---

## Step 4: Install stitch-kit plugin (Claude Code)

```bash
/plugin marketplace add https://github.com/gabelul/stitch-kit.git
/plugin install stitch-kit@stitch-kit
```

All 34 skills in one command. The `stitch-kit` agent is included — it shows up automatically after restart.

---

## Step 5: Verify the full setup

Run the orchestrator to confirm everything works:

```
"Use Stitch to design a simple login screen"
```

Expected behavior:
1. `stitch-orchestrator` activates
2. It runs `list_tools` and finds Stitch MCP tools
3. It generates a Design Spec
4. It creates a project via `create_project`
5. It generates a screen via `generate_screen_from_text`
6. It retrieves the screen via `get_screen`
7. It asks you which framework to convert to

If this completes, you're fully set up.

---

## Troubleshooting

| Symptom | Likely cause | Fix |
|---------|-------------|-----|
| `list_tools` doesn't show Stitch tools | MCP not configured or client not restarted | Redo Step 3; restart your client |
| "Unauthenticated" or 401 error | API key invalid or expired | Generate a new key at stitch.withgoogle.com/settings |
| `create_project` fails with 403 | Account doesn't have Stitch access | Visit stitch.withgoogle.com and request access |
| `generate_screen_from_text` returns empty | Bad prompt or project ID format | Use `stitch-mcp-generate-screen-from-text` skill — it includes ID format rules |
| `get_screen` returns 404 | Wrong ID format | **projectId and screenId must be numeric only** — no `projects/` prefix |
| Generated HTML won't download | GCS URL expired or requires redirects | Use `bash scripts/fetch-stitch.sh "[url]" "temp/output.html"` |
| Plugin not activating | Wrong install command or repo URL | Verify you used `@stitch-kit` — not `@stitch-pro` or `@stitch-skills` |

---

## Network requirements

Stitch MCP makes outbound requests to:
- `stitch.googleapis.com` — remote MCP server
- `storage.googleapis.com` — file downloads (HTML, screenshots)
- `accounts.google.com` — OAuth (if using OAuth instead of API key)

If you're behind a corporate proxy or VPN, ensure these domains are allowed.

---

## Offline / no-MCP mode

If you cannot configure Stitch MCP, the orchestrator still works in **prompt-only mode**:
- Steps 1–3 run normally (spec generation, prompt assembly)
- Instead of generating the screen, it outputs a ready-to-copy Stitch prompt
- You paste that prompt at stitch.withgoogle.com manually
- Then you can still use the conversion skills on the downloaded HTML

---

## Authentication alternatives

### OAuth (for restricted environments)

If you can't store API keys on disk, Stitch supports OAuth via Google Cloud:

```bash
gcloud auth login
gcloud auth application-default login
gcloud config set project YOUR-PROJECT-ID
gcloud beta services mcp enable stitch.googleapis.com --project=YOUR-PROJECT-ID
```

Then use Bearer token auth instead of API key. See [full OAuth guide](https://stitch.withgoogle.com/docs/mcp/setup).

> Note: OAuth tokens expire hourly and need manual refresh. API keys are simpler for most users.

---

## References

- Official Stitch MCP setup: https://stitch.withgoogle.com/docs/mcp/setup
- Plugin repo: https://github.com/gabelul/stitch-kit
- Skills index: `docs/skills-index.md`
- MCP tool reference: `docs/mcp-naming-convention.md`

Versions

The database has no other skills named stitch-setup.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 9954cb1f554e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100stitch-mcp
    Connects a coding agent to Google Stitch through the stitch-mcp CLI and MCP proxy, so the agent can read a screen's HTML and screenshot and rebuild it in the project's own framework. Use when a user says "implement this Stitch screen", "hook Stitch up to Claude Code / Cursor /…
  • 100stitch-skill-creator
    Meta-skill for creating new stitch-kit skills. Enforces naming conventions, SKILL.md structure, examples format, and the Design-First SOP. Use when adding new framework support, a new domain-specific prompt architect, or any new capability to the stitch-kit plugin.
  • 100stitch-to-react
    Converts Google Stitch exports into React components with design DNA integration. Use when user references design-intent/google-stitch exports, mentions "convert Stitch output", "Stitch to React", or processes Stitch code directories containing HTML + PNG pairs.
  • 100stitch
    Operate Google Stitch through an already configured Stitch MCP server. Use when the user explicitly mentions Stitch or asks to generate, edit, vary, import, export, synchronize, or convert Stitch screens; manage a Stitch design system; run a resumable multi-page Stitch loop; or…
  • 100generating-stitch-screens
    Generates Stitch screens from authored prompt files using MCP tools. Reads prompt sections, sends each to Stitch for generation, and fetches resulting images and code. Use when user mentions "generate in stitch", "create stitch screens", "run prompts in stitch", "send prompts to…
  • 100stitch-sdk-domain-design
    Design the domain model for the Stitch SDK. Use when mapping MCP tools to domain classes and bindings in domain-map.json. This is Stage 2 of the generation pipeline.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.