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.tsin the Sketchie repository.
Two environment variables configure the server:
| Variable | Meaning | Default |
|---|---|---|
SKETCHIE_API_KEY | Your API key, sent as a Bearer token. | unset |
SKETCHIE_API_URL | API 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.
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:
{
"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
| Tool | What 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. |