list_projectsLABSCO SUMMARY
Design files become something an assistant can read, not just link to.
The pairing that does the work is the object tree plus the image export: the model can both traverse the structure and look at what a component renders as. That is what makes design-to-code and design-system questions answerable from the file itself rather than from a screenshot someone pasted.
What it is
A server over Penpot's API. It pulls design files, caches them, and lets the model traverse the object tree or render a single component out as a picture, so design questions can be answered against the real file.
What you get
- List every project in the account, and the files inside one
- Retrieve a Penpot file by ID and keep it cached for follow-up questions
- Walk the object tree of any object in the file
- Search objects inside a file by name
- Export an object as an image, and read rendered component images back as a resource
- Command-line helpers that draw a tree view of a file or validate one against the schema
Requirements
Python 3.12+ and a Penpot account. Install with pip install penpot-mcp or run it with uvx. Credentials go in PENPOT_API_URL, PENPOT_USERNAME and PENPOT_PASSWORD - it signs in as your user, so it sees whatever you see. Penpot's cloud site sits behind CloudFlare; if API calls start getting blocked, log in to design.penpot.app in a browser and clear the challenge, then retry.
Setup effort
One command plus credentials — pip install penpot-mcp, then supply credentials
USE CASES
01
Building a component from the design instead of a screenshot
Fetch the file, walk the object tree of the component, and export it as an image to check the result against.
02
Finding where a pattern is used
Search a file's objects by name, then read the tree around each hit to see how it is composed.
03
Getting oriented in an account you just joined
List the projects, then the files in the one you care about, before opening anything.
04
Documenting a design system
Pull the components out of the file and export images for each, so the written documentation has the real artwork beside it.
6 tools
Listed in project docs. Your client may show a different list.
get_project_filesget_fileexport_objectget_object_treesearch_objectBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- uvx on PATH
- Python 3.12+
- PENPOT_PASSWORD in your environment
- PENPOT_USERNAME in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install penpot-mcpMCP Clients
Claude Desktop, Cursor
JSON
{
"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>"
}
}
}
}
