kicad-mcp-server — Claude Code MCP server
This MCP server lets an AI coding client assist with PCB design in KiCad 9.x.
claude mcp add kicad-mcp-server -- uvx kicad-mcp-serverWhat kicad-mcp-server does
kicad-mcp-server connects an AI client to PCB design work in KiCad 9.x. It runs as an MCP server, giving the agent a route into the project context needed for board design tasks.
The server is launched with uvx. In Claude Code, one command adds the MCP server; other supported clients include Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
Its stated target is KiCad 9.x. Projects built with another KiCad version should be checked before relying on the connection.
What it helps with
- design a printed circuit board in KiCad
- connect an AI agent to a PCB project
- review a board through MCP
- work on KiCad design tasks from an AI client
Example prompts for the agent
- Design a PCB for this circuit in KiCad 9.x.
- Review the current board project and suggest changes.
- Help me continue this PCB design in KiCad.
How to install kicad-mcp-server
Platform CLI
claude mcp add kicad-mcp-server -- uvx kicad-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>
Platform CLI
codex mcp add kicad-mcp-server -- uvx kicad-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>
Config file
{
"mcpServers": {
"kicad-mcp-server": {
"command": "uvx",
"args": [
"kicad-mcp-server"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>
Config file
{
"servers": {
"kicad-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"kicad-mcp-server"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>
Platform CLI
gemini mcp add kicad-mcp-server uvx kicad-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about kicad-mcp-server
How do I install kicad-mcp-server in Claude Code?
Run claude mcp add kicad-mcp-server -- uvx kicad-mcp-server.
What does kicad-mcp-server do?
It connects an AI agent to PCB design tasks in KiCad 9.x through MCP.
Which platforms support kicad-mcp-server?
It supports Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
