Penpot MCP Server — Design Tool Integration
Engineering guide to the Penpot MCP Server: architecture, infrastructure, tools, authentication, Claude Code integration, design system, and API reference. Covers everything needed to operate and extend the self-hosted Penpot design tool integration.
| Responsible | Juan Palomino |
|---|---|
| Last Update | 04/08/2026 |
| Completion Time | 5 days 16 hours |
| Members | 1 |
-
Module 7: Penpot API Reference19Lessons · 5 days 16 hr
-
System Architecture
-
Service Map & URLs
-
Transport Modes: stdio vs SSE
-
Storage Backend Decision Tree
-
Railway Environment Variables
-
S3 Storage Configuration
-
Read Tools: Projects, Files, Pages, Objects
-
Write Tools: Add, Move, Update, Delete
-
Export & Asset Tools
-
API Key Authentication
-
Key Rotation Procedure
-
MCP Config: .mcp.json
-
Registering & Verifying Servers
-
Mint Design System Overview
-
Brand Tokens & Design Pipeline
-
Populate Scripts
-
Penpot REST API Basics
-
update-file Change Format
-
Gotchas & Troubleshooting
-