Penpot MCP server

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

What you can do with the Penpot MCP server

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

  • Use the get profile tool in Penpot
  • Use the get page tool in Penpot
  • Use the manage libraries tool in Penpot
  • Use the manage pages tool in Penpot
  • Use the get file summary tool in Penpot
  • Use the manage comments tool in Penpot

Supported Tools

get_profile

Get Profile

Retrieve the current user's profile information including name, email, language, and default team/project IDs.

get_page

Get Page

Retrieve the contents of a specific page in a design file, including all objects/shapes on the page. If no pageId is provided, returns the first page.

manage_libraries

Manage Libraries

List, link, or unlink shared design libraries for a file. Libraries provide reusable components, colors, and typographies across files.

manage_pages

Manage Pages

Add, rename, reorder, or delete pages within a design file. Pages are managed through the file update mechanism.

get_file_summary

Get File Summary

Get a lightweight summary of a design file's components, variants, colors, and typographies without loading the full file data.

manage_comments

Manage Comments

Create, list, reply to, resolve, and delete comments and comment threads on design files. Use **action** to specify the operation.

manage_project

Manage Project

Create, rename, delete, or pin/unpin a project within a team. Use **action** to specify the operation.

list_projects

List Projects

List all projects within a team. Projects are containers for grouping design files.

list_teams

List Teams

List all teams the current user belongs to, including owned teams and teams they've been invited to. Includes team metadata and member counts.

manage_file

Manage File

Create, rename, delete, or update sharing settings of a design file. Use **action** to specify the operation.

manage_team

Manage Team

Create, rename, or delete a team. Also retrieve team details and members, invite teammates, and manage member roles. Use **action** to specify the operation.

get_file

Get File

Retrieve detailed information about a design file, including its pages, component summary, and metadata. For full file data with all shapes, use the **includeData** flag.

list_files

List Files

List design files by project, recent files by team, shared library files, or search files by name. Use **source** to choose the listing mode.

export_file

Export File

Export a design file in Penpot's native .penpot binary format. Can optionally include linked libraries and embed assets for standalone import.

add_media_from_url

Add Media from URL

Upload a media asset (image) to a design file from a URL. The image will be downloaded and stored as a media object in the file.

manage_file_snapshot

Manage File Snapshot

Save a named version of a design file, restore a saved version, or delete a user-created version. Restoring replaces the current file contents; retrieve get_file again before making further edits.

list_file_snapshots

List File Snapshots

List the visible saved versions of a design file, including labels, revision numbers, and creator information. Use the returned snapshot IDs to restore a version.

Connect Penpot 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 Penpot in Metorial. In your Metorial portal, enable the Penpot 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 Penpot tools.

Run Penpot through the Metorial gateway

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

  • Give Penpot and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Penpot 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 Penpot

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.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

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. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Technical notes for Penpot

Create, manage, and export design files and prototyping projects. Manage teams with role-based access, organize projects, and manipulate design elements including shapes, components, pages, and media assets. Search and filter shapes by type, color, font, or text content. Upload media assets, add comments for collaboration, export design tokens for code workflows, and export files in native .penpot format.

Frequently asked questions

Common questions about connecting Penpot to AI agents with Metorial.

  1. How many tools does the Penpot MCP server have?
    The Penpot MCP server exposes 17 tools, including Get Profile, Get Page, Manage Libraries. Each one is governed and traced through Metorial.
  2. Penpot 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 Penpot MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Penpot and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Penpot MCP server yourself or use the hosted gateway.

Connect Penpot to production AI agents

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