Skip to Content
Penpot MCP Server — Design Tool Integration

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 Reference
    19Lessons · 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