Sketchie MCP setup: Claude Desktop, Claude Code, Claude app

Sketchie ships an MCP server, so any MCP-capable agent can generate and edit whiteboard explainer videos as native tools. Set it up in Claude Code, Claude Desktop, and the Claude app.

What you need

  • A Sketchie API key (sk_...). Create one in the app under Settings. API access is included on every paid plan.
  • The Sketchie MCP server. It runs on bun and lives at packages/mcp/src/index.ts in the Sketchie repository.

Two environment variables configure the server:

VariableMeaningDefault
SKETCHIE_API_KEYYour API key, sent as a Bearer token.unset
SKETCHIE_API_URLAPI base URL, including the /api prefix.https://sketchie.ai/api

Claude Code

Register the server with one command. Replace the path with your checkout of the Sketchie repository.

Terminal
claude mcp add sketchie \
  -e SKETCHIE_API_URL=https://sketchie.ai/api \
  -e SKETCHIE_API_KEY=sk_... \
  -- bun /path/to/sketchie/packages/mcp/src/index.ts

Verify it registered with claude mcp list. In a session, ask Claude to generate an explainer and it will call the Sketchie tools.

Claude Desktop

Open the Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add Sketchie under mcpServers, then restart Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "sketchie": {
      "command": "bun",
      "args": ["/path/to/sketchie/packages/mcp/src/index.ts"],
      "env": {
        "SKETCHIE_API_URL": "https://sketchie.ai/api",
        "SKETCHIE_API_KEY": "sk_..."
      }
    }
  }
}

After the restart, the Sketchie tools appear in the tools menu. You can open the config quickly from Settings, Developer, Edit Config.

The Claude app

The Claude desktop application uses the same claude_desktop_config.json as above. Add custom connectors from Settings, Connectors, Add custom connector.

The Sketchie MCP server runs as a local process (stdio transport), so it works wherever Claude can launch a local command, which is Claude Code and the Claude desktop app. A hosted connector for the Claude web and mobile apps is on the roadmap. In the meantime, the HTTP API, SDK, and CLI cover every other environment.

The tools

ToolWhat it does
sketchie_generate_explainer Start a generation from input (with optional length, aspect, voice). Returns the queued record.
sketchie_get_explainer Fetch status, the video URL once ready, and the editable scene graph.
sketchie_edit_explainer Apply a plain-language instruction as a targeted re-render.
sketchie_list_explainers List the explainers your key owns.
sketchie_list_voices List the narration voices.