KiCad MCP Server
Allows inspection, editing, analysis, and rendering of PCB layouts using KiCad's Python API, including tools for managing footprints, tracks, vias, zones, nets, text, shapes, dimensions, groups, selection, appearance, exports, screenshots, and CLI operations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KiCad MCP ServerShow me the current board stackup"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KiCad MCP Server ๐๐
An implementation of the Model Context Protocol (MCP) server for KiCad 9.0+, enabling Large Language Models (LLMs) like Claude to inspect, edit, analyze, and render PCB layouts in real-time.
It leverages the official kicad-python API to communicate with running KiCad instances over local Unix domain sockets or Windows named pipes.
๐ Key Features
This server exposes 14 specialized modules providing comprehensive control over the board layout:
Module | Description | Key Tools |
๐๏ธ Board | Inspect/update PCB configurations, units, and canvas settings |
|
๐งฉ Footprints | Manage component properties, placements, and pads |
|
โก Tracks & Vias | List, route, resize, and remove traces and vias |
|
๐บ๏ธ Zones | Control copper pours, fill/unfill, and rule boundaries |
|
๐ Nets | Import netlists, manage classes, and trace connectivity |
|
๐ค Text | Add and style free-standing board text labels and textboxes |
|
๐จ Shapes | Draw graphic segments, rects, circles, and polygons on user layers |
|
๐ Dimensions | Place precise dimension and measurement markings |
|
๐ฅ Groups | Read structural component groupings (KiCad 10+) |
|
๐ฏ Selection | Read active selection, select footprints, and invoke actions |
|
๐๏ธ Appearance | Adjust layer visibility, contrast modes, ratsnest lines, and flip view |
|
๐ฆ Exports | Export manufacturing files (Gerbers, drills, position, ODB++, PDF, STEP) |
|
๐ธ Screenshots | Render visual PNG screenshots of the board or specific selection |
|
๐ป CLI Wrapper | Headless CLI automation for schematics, ERC, DRC, and more |
|
Related MCP server: KiCAD Schematic Manipulation MCP Server
๐ Prerequisites
KiCad 9.0 or higher must be installed and running.
Enable the IPC API inside KiCad:
Go to Preferences โ Preferences...
Navigate to Plugins
Check the Enable KiCad IPC API box.
Python 3.10+ (tested on Python 3.10 through 3.14).
โ๏ธ Installation & Setup
We recommend using uv for fast and isolated environment setup.
1. Clone the Repository
git clone https://github.com/brovk2008/Kicad-MCP-server.git
cd Kicad-MCP-server2. Set Up the Virtual Environment
# Using uv (recommended)
uv venv
uv pip install -e .
# Or using standard pip
python -m venv .venv
source .venv/bin/activate # Or `.venv\Scripts\activate` on Windows
pip install -e .Note: The project automatically applies a dynamic Protobuf descriptor pool patch to ensure compatibility with kicad-python 0.7.1 on Python 3.14.
๐ ๏ธ MCP Configuration
To use this server with Claude Desktop, add the configuration snippet below to your Claude configuration file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json
Configuration Snippet
{
"mcpServers": {
"kicad-mcp": {
"command": "uv",
"args": [
"run",
"--package",
"kicad-mcp",
"kicad-mcp"
],
"cwd": "C:/Users/techp/Downloads/more projects/Kicad mcp",
"env": {
"KICAD_API_SOCKET": "ipc:///tmp/kicad/api.sock"
}
}
}
}(Adjust the cwd directory to point to your local installation path. For Windows, the socket path defaults to ipc://%TEMP%\\kicad\\api.sock if not explicitly set).
๐งช Running Tests
A test suite is included to verify unit conversions, coordinate mappings, and error wrappers:
# Activate your virtual environment and run:
pytest tests/unit/๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityBmaintenanceEnables natural language interaction with KiCad projects, schematics, and PCBs, supporting project management, design rule checking, netlist extraction, and datasheet RAG search.2MIT
- Alicense-qualityDmaintenanceEnables AI tools to create, edit, and inspect KiCAD schematic files, including components, wires, labels, and sheets.MIT
- AlicenseCqualityCmaintenanceEnables AI coding assistants to control JLCPCB EDA for PCB automation, exposing 39 tools for component manipulation, routing, copper pour, DRC, and more. Includes a built-in PCB agent for orchestrating multi-step tasks.59183MIT
- Alicense-qualityDmaintenanceEnables AI assistants like Claude to interact with KiCAD for PCB design automation, providing comprehensive tool schemas and real-time project state access.642MIT
Related MCP Connectors
DXF and PDF/X-4 for AI agents: structured facts, PNG renders, an interactive in-chat viewer.
Agent-first CAD: editable .kcad.ts source, deterministic review, OpenCASCADE kernel.
Electronic component datasheets for AI agents โ specs, pinouts, package data on demand.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/brovk2008/Kicad-MCP-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server