# kicad-mcp-server

This MCP server lets an AI coding client assist with PCB design in KiCad 9.x.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: bunnyf
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bunnyf/pcb-mcp
- Updated: 2026-01-17
- HTML: https://affpapa.org/en/nevibecode/mcp/kicad-mcp-server

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add kicad-mcp-server -- uvx kicad-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>

### Codex

**Platform CLI**
```bash
codex mcp add kicad-mcp-server -- uvx kicad-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add kicad-mcp-server uvx kicad-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from kicad-mcp-server <command>

## When to use it
- 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
- 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.

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36427
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51104
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16073
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7527
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6144
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3851

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md