kicad-mcp-python
MCP serverCommunity
A PCB-only KiCad server built on the official kicad-python IPC library, checking board state with screenshots before and after each edit. By Finerestaurant.
41 starsUpdated 1 year agoGitHub data from 5 Nov 2026
At a glance
- Type
- MCP server
- Works with
- KiCad
- How it connects
- Drives a running copy of the tool
- Access
- Can modify models
- Tool versions
- Not stated; needs a KiCad build with the IPC API server and kicad-cli
- Operating systems
- Windows, macOS, Linux
- Needs a KiCad licence
- No
- Transport
- Local (stdio)
- AI clients documented
- Not stated in its documentation
- Licence
- Not stated in its documentation
- Language
- Python
What it can do
- Creates, modifies, moves, rotates and deletes PCB items such as footprints and tracks in a running KiCad session.
- Lists board items by type and summarises board status, including kicad-cli screenshots.
- Wraps each action in a before-and-after board check so the model can confirm the edit landed.
Limitations
- PCB only; schematic support is listed as planned.
- You build and install kicad-python yourself from a Git submodule before installing the server.
- No licence file or licence statement in the repository.
Install
git submodule update --init --depth 1
poetry install
poetry run python main.pyMCP servers and skills run code on your computer. Review the source before installing.
AI-generated models, drawings and results must be checked by a qualified engineer before use.