🚀 KiCad MCP
Integrating MCP into KiCad, welcome issues and pull requests.
🚀 Quick Start
- Download the KiCad Huaqiu Distribution 9.0.7-rc3 . You can also find a portable version on the github release page. The production-ready one shall be shipped with the release of KiCad 10. Install for the user while using the installer or use the portable version and extract it to a writable directory. Or the KiCad MCP Server will fail to initialize due to missing write permission while installing the python package.
- Open either the PCB or Schematic editor, click the "Robot" button to toggle the Copilot panel.
- Click the Settings (Gear) button, fill in both the OpenAI API Key and the OpenAI Endpoint. There shall be an existing built-in KiCad MCP Server available.
✨ Features
- Full MCP support Out of the box
- Built-in KiCad MCP Server
📚 Documentation
Architecture
KiCad MCP Client
The KiCad Client now has the full MCP capabilities by embedding the mcp-agent. KiCad editors (PCB/ Schematic) will atomically start a KiCad MCP Client instance on launch and pass both the dual-communicating IPC channel and the KiCad IPC API url to it.
KiCad IPC API
The KiCad IPC API forms the backbone of KiCad MCP, and is what makes it stand out from the other MCP clients. We are planning to add more scenario-driven APIs to it. Check out the source code of KiCad or KiCad Huaqiu-Electronics Distribution if you are interested in developing the KiCad IPC API. Our fork has always been keeping up to date with the latest KiCad release branch, and all the upstream changes are merged into it.
KiCad MCP Server
KiCad MCP Server exposes the KiCad IPC API as MCP tools based on the official MCP Python SDK. Currently, there are 72 tools available, and more will be added in the future.
The Frontend
We host NextChat on our server as the frontend. It interacts with the KiCad through the webview IPC API while KiCad forwards the messages between the UI and the mcp-agent.
Development
KiCad IPC API
Follow the official KiCad Development Guide.
KiCad MCP Server
- Locate the local KiCad MCP Server installation directory.
- Clone the repo and replace the entire directory.
cd /path/to/kicad-installation-directory # %LOCALAPPDATA%\Programs\KiCad\9.0\bin if installed for user
rm -rf ./kicad-mcp-server
git clone https://github.com/Huaqiu-Electronics/kicad-mcp-server.git
Don't forget to commit your changes and open a pull request.
Troubleshooting
Empty KiCad MCP TOOLs
If you find that the KiCad MCP Tools are empty, follow the steps below to fix it.
- Ensure the installation directory is writable.
- If you have configured a mirror for the python pip command, ensure the mirror has not banned your IP. The MCP SDKs pull a lot of python packages on the first launch.
Enabling new MCP Servers added
While new MCP Servers are disabled by default, you can check and enable them by clicking the button besides the attachment icon in the input box.










