Penpot MCP Server

A Model Context Protocol (MCP) server that provides full manipulation capabilities for Penpot - the open-source design tool. This server enables AI assistants to create, modify, and manage Penpot designs programmatically, similar to Figma plugin capabilities.

🐳 Multi-architecture Docker images available: linux/amd64, linux/arm64

🎬 See It In Action

Example chat interface created entirely through natural conversation with an AI assistant using this MCP server. See Example 7: Chat Interface for the complete conversation that generated this design.

The screenshot above demonstrates how you can describe a design in natural language, and the AI assistant will create it in Penpot using the MCP server's capabilities - handling layout, styling, components, and interactions automatically.

Features

🎨 Complete Design Manipulation

• Create & Manage Files: Create new design files, list projects, and manage file metadata
• Shape Operations: Create rectangles, circles, frames, paths, text, and SVG shapes
• Modify Designs: Update shape properties, move objects, resize, rotate, and style
• Page Management: Add, remove, and organize pages within files
• Component System: Create and manage reusable components

🔄 Real-time Operations

• Direct API integration with Penpot
• Session-based updates with revision tracking
• Support for batch operations

🛠️ Available Tools (76+ Tools!)

Project & File Management (8 tools)

• list_teams - List all accessible teams
• list_projects - List all accessible projects
• list_files - List files in a project
• get_file - Get file data and structure
• create_file - Create a new design file
• rename_file - Rename an existing file
• delete_file - Delete a file permanently

Page Management (8 tools)

• list_pages - List all pages in a file
• add_page - Add a new page to a file
• get_page_shapes - Get all shapes on a specific page (basic info)
• query_shapes - Query and filter shapes with criteria (like grep). Filter by type, area, color, font, text content. Select fields to return. Useful for bulk operations
• get_shape_properties - Get detailed properties of a specific shape (colors, text, fonts, effects, etc.)
• rename_page - Rename a page
• delete_page - Delete a page from a file
• move_shapes - Move shapes to different parent/frame or reorder

Shape Creation (6 tools)

• create_rectangle - Create rectangle shapes
• create_circle - Create circle/ellipse shapes
• create_frame - Create frame containers
• create_text - Create text elements with alignment (left, center, right, justify), fonts, and styling
• create_svg - Create SVG elements
• create_path - Create custom paths (planned)

Shape Manipulation (3 tools)

• update_shape - Modify shape properties (position, size, style, etc.)
• delete_shape - Remove shapes from the design
• duplicate_shapes - Duplicate shapes (planned)
• group_shapes - Group multiple shapes (planned)

Shape Alignment & Distribution (2 tools)

• align_shapes - Align multiple shapes (left, center, right, top, middle, bottom)
• distribute_shapes - Distribute shapes evenly with equal spacing (horizontal, vertical)

Component System (5 tools)

• create_component - Create reusable component from shape
• update_component - Update component name/path
• delete_component - Delete component from library
• list_components - List all components in file
• instantiate_component - Create component instance (planned

... View full README on GitHub