Connect Sketch to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the parse document tool in Sketch
Use the extract text content tool in Sketch
Use the generate document tool in Sketch
Use the inspect layers tool in Sketch
Use the extract colors tool in Sketch
Use the generate page tool in Sketch
Supported Tools
parse_document
Parse Document
Parse Sketch document JSON data and return a structured overview of the document contents. Accepts the raw JSON from a Sketch file's **document.json**, **meta.json**, and **page JSON** files, and returns a summary including pages, artboards, layer counts, symbols, shared styles, fonts, and version info.
Use this to quickly understand the structure and contents of a Sketch document without manually inspecting the raw JSON.
extract_text_content
Extract Text Content
Extract all text content from text layers in a Sketch document. Returns the string content of every text layer along with the layer name and page it belongs to.
Use this for content auditing, localization workflows, copy extraction, or checking text across a design for consistency or typos.
generate_document
Generate Document
Generate draft Sketch document structures including **document.json**, **meta.json**, and **page JSON** files. Produces draft JSON structures and downloadable JSON files. Validate and complete them against the target Sketch file-format schema before assembling a native document.
Use this to prepare draft pages, artboards, layers, color assets, and shared styles for further completion and validation.
inspect_layers
Inspect Layers
Search and inspect layers within Sketch page JSON data. Find layers by **object ID**, **name**, or **layer class** (e.g. artboard, text, symbolMaster, group, rectangle). Returns a summarized view of matching layers including their type, position, dimensions, visibility, and relevant metadata.
Use this to drill into specific layers or find all layers of a certain type across pages.
extract_colors
Extract Colors
Extract unique color entries from a Sketch document. Collects colors from document color assets, shared layer styles, shared text styles, shared swatches, and individual layer fills, borders, and text attributes across all pages. Returns each color in both hex and rgba formats along with its source.
Use this to audit the color palette of a design, check for consistency, or export a design system's color tokens.
generate_page
Generate Page
Generate a Sketch page JSON structure with artboards and layers. Produces draft JSON and a downloadable page JSON file. The draft is not a complete, version-validated native Sketch file.
Use this to programmatically create page content for Sketch documents, including artboards sized for common device screens and layers with fills, borders, and text.
extract_symbols
Extract Symbols
Extract reusable symbol sources from unpacked Sketch page JSON. Returns each symbol ID, object ID, name, containing page, and dimensions for design-system inventories and symbol-instance lookup.
Enable Sketch in Metorial. In your Metorial portal, enable the Sketch MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Sketch tools.
Enable Sketch in Metorial. In your Metorial portal, enable the Sketch MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Sketch tools.
Enable Sketch in Metorial. In your Metorial portal, enable the Sketch MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Sketch tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Sketch in Metorial. In your Metorial portal, enable the Sketch MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Sketch tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Sketch in Metorial. In your Metorial portal, enable the Sketch MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Sketch tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Sketch through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Sketch and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Sketch tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Inspect unpacked Sketch document JSON using the documented open file format. Summarize pages and layers, search layers, extract colors, text, and reusable symbols, and generate downloadable draft page and document JSON. Draft generation does not certify native .sketch compatibility and requires completion and validation against the target file-format schema.
Frequently asked questions
Common questions about connecting Sketch to AI agents with Metorial.
How many tools does the Sketch MCP server have?
The Sketch MCP server exposes 7 tools, including Parse Document, Extract Text Content, Generate Document. Each one is governed and traced through Metorial.
Does the Sketch MCP server support triggers?
Sketch exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Sketch MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Sketch MCP server through the same Metorial URL.
How do I give only some teams access to Sketch?
Use role-based access control to decide which teams, users, and agents can use Sketch and which of its tools they can call.
Can I self-host the Sketch MCP server?
Yes. Metorial is open source, so you can run the Sketch MCP server yourself or use the hosted gateway.
Connect Sketch to production AI agents
See how Metorial gives your team governed access to Sketch, with tracing and security controls built in.