penpot-mcp

Overview

Penpot MCP is a Model Context Protocol server that connects AI language models with Penpot, an open-source design and prototyping platform. It enables AI assistants to understand, analyze, and interact with design files programmatically. The server provides real-time design access, component analysis, export automation, and design validation capabilities. With support for Claude Desktop and Cursor IDE, it bridges the gap between design and development through AI-powered workflows.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_projects

  List all Penpot projects

  Try:Show me all my Penpot projectsTry:List my design projects
• get_project_files

  Get files for a specific project

  Try:List all files in my projectTry:Show me the files in project X
• get_file

  Retrieve a Penpot file by its ID and cache it

  Try:Get the file with ID 12345Try:Retrieve my homepage design file
• export_object

  Export a Penpot object as an image

  Try:Export the logo component as PNGTry:Save the button object as an image
• get_object_tree

  Get the object tree structure for a Penpot object

  Try:Show me the structure of this componentTry:Get the tree hierarchy for this element
• search_object

  Search for objects within a Penpot file by name

  Try:Find all button componentsTry:Search for objects with 'hero' in the name

Comparable tools

Installation

pip install penpot-mcp

PENPOT_API_URL=https://design.penpot.app/api
PENPOT_USERNAME=your_penpot_username
PENPOT_PASSWORD=your_penpot_password
PORT=5000
DEBUG=true

{
  "mcpServers": {
    "penpot": {
      "command": "uvx",
      "args": ["penpot-mcp"],
      "env": {
        "PENPOT_API_URL": "https://design.penpot.app/api",
        "PENPOT_USERNAME": "your_penpot_username",
        "PENPOT_PASSWORD": "your_penpot_password"
      }
    }
  }
}

FAQ

What AI assistants are supported with this MCP server?

Penpot MCP primarily supports Claude Desktop and Cursor IDE, with potential compatibility for any MCP-compatible AI assistant.

Can I use this with my self-hosted Penpot instance?

Yes, you can configure the PENPOT_API_URL environment variable to point to your self-hosted Penpot instance.

On Hacker News

Recent discussion from the developer community.

• Show HN: Penpot MCP Server▲ 2
  Story by jmrobles · 2025-06-01

Compare penpot-mcp with