Zeplin MCP server

Connect Zeplin 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.

Deploy ZeplinBook a demo

What you can do with the Zeplin MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get styleguide tool in Zeplin
  • Use the list screen versions tool in Zeplin
  • Use the delete screen note tool in Zeplin
  • Use the update project tool in Zeplin
  • Use the list colors tool in Zeplin
  • Use the get design tokens tool in Zeplin

Supported Tools

get_styleguide

Get Styleguide

Retrieve detailed information about a specific Zeplin styleguide.

list_screen_versions

List Screen Versions

List all versions of a specific screen in a Zeplin project. Screen versions represent the history of published design updates. Supports pagination.

delete_screen_note

Delete Screen Note

Delete a note from a screen in a Zeplin project.

update_project

Update Project

Update a Zeplin project's name or description.

list_colors

List Colors

List all colors from a Zeplin project or styleguide. Provide either a **projectId** or **styleguideId**. Supports pagination.

get_design_tokens

Get Design Tokens

Retrieve all exported design tokens from a Zeplin project or styleguide, including colors, text styles, and spacing tokens in a structured format. Provide either a **projectId** or **styleguideId**.

get_flow_board

Get Flow Board

Retrieve a specific flow board from a Zeplin project, including its nodes and connectors that define user journey maps and navigation diagrams.

list_flow_boards

List Flow Boards

List all flow boards in a Zeplin project. Flow boards represent user journey maps or navigation diagrams. Supports pagination.

list_projects

List Projects

List all Zeplin projects the authenticated user is a member of. Returns project metadata including name, platform, status, and resource counts. Supports pagination.

list_spacing_tokens

List Spacing Tokens

List all spacing tokens from a Zeplin project or styleguide. Provide either a **projectId** or **styleguideId**. Returns spacing definitions used in the design system.

list_organizations

List Organizations

List all Zeplin organizations (workspaces) that the authenticated user is a member of. Returns organization names, IDs, and logos.

list_screens

List Screens

List all screens in a Zeplin project. Returns screen metadata including name, thumbnail, and timestamps. Supports pagination.

create_screen_note

Create Screen Note

Create a note on a screen in a Zeplin project. Defaults to a yellow note at the center of the screen when position or color is omitted.

invite_project_member

Invite Project Member

Invite a user to a Zeplin project by their email, username, or user ID. Zeplin assigns the membership role; the project invitation API does not accept a role.

list_styleguides

List Styleguides

List all Zeplin styleguides the authenticated user is a member of. Optionally filter by linked project, linked styleguide, or workspace. Supports pagination.

list_text_styles

List Text Styles

List all text styles from a Zeplin project or styleguide. Provide either a **projectId** or **styleguideId**. Returns typography definitions including font family, size, weight, and other properties.

create_project_color

Create Project Color

Create a new color in a Zeplin project's local styleguide. Specify the RGBA values and a name.

get_project

Get Project

Retrieve detailed information about a specific Zeplin project including its metadata, resource counts, linked styleguide, and workflow status.

get_component

Get Component

Retrieve detailed information about a specific component from a Zeplin project or styleguide. Provide either a **projectId** or **styleguideId**.

list_screen_notes

List Screen Notes

List a page of screen notes and their comments in a Zeplin project. Screen annotations are a separate resource.

get_screen

Get Screen

Retrieve detailed information about a specific screen in a Zeplin project, including its current section, variant, tags, and thumbnail. Use list_screen_versions for its version history.

list_components

List Components

List components from a Zeplin project or styleguide. Provide either a **projectId** or **styleguideId** to specify the source. Supports pagination.

remove_project_member

Remove Project Member

Remove a member from a Zeplin project by their user ID.

add_note_comment

Add Note Comment

Add a comment (reply) to an existing note on a screen. Use this to participate in design discussions.

list_project_members

List Project Members

List all members of a Zeplin project, including their roles and profile information. Supports pagination.

update_screen_note

Update Screen Note

Resolve or reopen a screen note, or change its position or color. Comment text is separate from note properties.

get_current_user

Get Current User

Identify the authenticated Zeplin account and retrieve its profile details.

get_screen_version

Get Screen Version

Retrieve design details for a published screen version, including layers, assets, image metadata, and commit information. Omit versionId to retrieve the latest version.

Connect Zeplin to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Zeplin in Metorial. In your Metorial portal, enable the Zeplin MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Zeplin tools.

Run Zeplin through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Zeplin and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Zeplin tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Zeplin

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis.

Technical notes for Zeplin

Access and manage design projects, screens, components, and styleguides in Zeplin. Retrieve design specs, assets, code snippets, and design tokens. Create and manage notes and comments on screens. Publish screen versions with PNG/JPEG images. Manage design tokens including colors, text styles, and spacing tokens at project and styleguide levels. Access flow boards, variable collections, and connected components. Invite and remove project and styleguide members. Manage organization members and workspace settings.

Frequently asked questions

Common questions about connecting Zeplin to AI agents with Metorial.

  1. How many tools does the Zeplin MCP server have?
    The Zeplin MCP server exposes 28 tools, including Get Styleguide, List Screen Versions, Delete Screen Note. Each one is governed and traced through Metorial.
  2. Zeplin exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Zeplin MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Zeplin and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Zeplin MCP server yourself or use the hosted gateway.

Connect Zeplin to production AI agents

See how Metorial gives your team governed access to Zeplin, with tracing and security controls built in.

Book a demoDeploy Zeplin