Summary
Validate the local Penpot MCP runtime against the self-hosted Penpot instance so we can confidently build the design-system workflow on top of a real, working bridge.
Scope
- start and verify local MCP runtime
- verify connection from MCP to local Penpot
- validate
execute_code
- validate
export_shape
- verify whether
import_image works in local mode
- define the local Penpot custom patch strategy before adding new MCP tools
- document findings and blockers
Acceptance Criteria
- MCP is running locally against the self-hosted Penpot instance
- at least one
execute_code call succeeds
- at least one shape export succeeds
- the result is documented with explicit supported/unsupported capabilities
Tasks
Additional notes
This issue is the confidence gate before adding MCP-specific tools for design-system automation.
The patch strategy is intentionally part of this validation gate: before implementing list_pages_and_boards, batch_export_page, or component_structure_report, we need a clear rule for how local Penpot customizations are isolated and maintained. The preferred approach is to keep changes inside the existing MCP area whenever possible, avoid touching Penpot core unless strictly necessary, and document every local customization so future upstream upgrades remain manageable.
Summary
Validate the local Penpot MCP runtime against the self-hosted Penpot instance so we can confidently build the design-system workflow on top of a real, working bridge.
Scope
execute_codeexport_shapeimport_imageworks in local modeAcceptance Criteria
execute_codecall succeedsTasks
execute_codeexample successfullyimport_imageis available in local modeAdditional notes
This issue is the confidence gate before adding MCP-specific tools for design-system automation.
The patch strategy is intentionally part of this validation gate: before implementing
list_pages_and_boards,batch_export_page, orcomponent_structure_report, we need a clear rule for how local Penpot customizations are isolated and maintained. The preferred approach is to keep changes inside the existing MCP area whenever possible, avoid touching Penpot core unless strictly necessary, and document every local customization so future upstream upgrades remain manageable.