Which integrations are available for this server?

Enables real-time inspection and control of KiCad 10 schematics and PCB layouts, with tools for retrieving symbols, labels, footprints, tracks, vias, nets, layer stackup, and saving designs.

How do I use kicad-mcp-kipy?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@kicad-mcp-kipy List all components in the current schematic" 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-kipy

KiCad MCP server for KiCad 10 — powered by kipy, the official KiCad Python API.

Connects AI assistants (Claude, Bob, etc.) to a running KiCad 10 instance via the Model Context Protocol, enabling real-time inspection and control of schematics and PCB layouts.

Why kicad-mcp-kipy?

	kicad-mcp (Huaqiu)	kicad-mcp-kipy
KiCad 10 support	❌ (KiCad 9 JSON API)	✅ (KiCad 10 Protobuf API)
macOS process detection	❌ (Issue #3)	✅
Dependencies	115 packages	~40 packages
Python API	Custom JSON/NNG	kipy (official KiCad bindings)

Related MCP server: KiCad MCP Server

Requirements

KiCad 10.x (macOS / Linux / Windows)
Python 3.11+
uv (recommended) or pip

Installation

Using uvx (recommended — no install needed)

uvx kicad-mcp-kipy

Using pip

pip install kicad-mcp-kipy
kicad-mcp-kipy

Setup

1. Enable KiCad IPC API

In KiCad's Schematic Editor or PCB Editor:

Preferences → Preferences → Scripting → Enable IPC API ✅

2. Register in your MCP client (Bob / Claude Desktop)

.bob/mcp.json (workspace-level):

{
  "mcpServers": {
    "kicad": {
      "command": "uvx",
      "args": ["kicad-mcp-kipy"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "kicad": {
      "command": "uvx",
      "args": ["kicad-mcp-kipy"]
    }
  }
}

3. Open a project in KiCad

Open your schematic or PCB file in KiCad before connecting — the IPC API is only active when an editor is open.

Available Tools

General

Tool	Description
`get_kicad_version`	Get running KiCad version
`get_open_documents`	List open schematic / PCB files
`run_action`	Execute a KiCad menu action (e.g. `"zoom_fit_in_window"`)

Schematic

Tool	Description
`schematic_get_symbols`	Get all symbols (reference, value, position)
`schematic_get_labels`	Get all net labels
`schematic_get_title_block`	Get title block info
`schematic_get_as_string`	Get schematic as KiCad S-expression text
`schematic_get_hierarchy`	Get hierarchical sheet structure
`schematic_save`	Save the schematic

PCB

Tool	Description
`pcb_get_footprints`	Get all footprints (reference, value, position, layer)
`pcb_get_tracks`	Get all tracks (start, end, layer, width)
`pcb_get_vias`	Get all vias (position, drill size)
`pcb_get_nets`	Get all nets (name, number)
`pcb_get_enabled_layers`	Get enabled layer list
`pcb_get_stackup`	Get board stackup (layer structure, thickness)
`pcb_get_title_block`	Get PCB title block info
`pcb_get_as_string`	Get PCB as KiCad S-expression text
`pcb_save`	Save the PCB

How it works

AI Assistant (MCP Client)
    ↕  stdio (JSON-RPC)
kicad-mcp-kipy (MCP Server)
    ↕  pynng / NNG IPC socket  (/tmp/kicad/api.sock)
KiCad 10 IPC API Server (built-in)
    ↕  C++ SDK
KiCad Schematic / PCB Editor

KiCad 10 exposes a Protobuf-based IPC API over a local NNG socket. kipy provides Python bindings for this API. This server wraps those bindings as MCP tools.

Development

git clone https://github.com/mnori0211/kicad-mcp-kipy
cd kicad-mcp-kipy
uv sync
uv run kicad-mcp-kipy

kipy (kicad-python) — Official KiCad Python API bindings
kicad-mcp (Huaqiu) — Alternative MCP server (KiCad 9)
Model Context Protocol

License

MIT — see LICENSE

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

strata
ai.klavis
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Agent Orchestration Autonomous Agents Developer Tools
25,748
slimaOAuth
io.github.slima-ai
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
Developer Tools
21
OneSchema MCP Server
co.oneschema
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Data Platforms App Automation
1
mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2

Related MCP Servers

KiCad MCP Server
Embedded system Developer Tools
Seeed-Studio
A
license
B
quality
B
maintenance
An MCP server that enables AI assistants to analyze schematics, inspect PCBs, trace connections, validate designs, and generate embedded code for KiCad projects.
Updated 17 days ago (2026-08-27 09:01 UTC)
39
125
MIT
KiCad MCP Server
Embedded system Developer Tools
aswego123
F
license
Not graded
quality
D
maintenance
A Model Context Protocol (MCP) server that exposes KiCad PCB design automation tools to AI assistants and other MCP clients.
Updated a year ago (2025-10-07 10:58 UTC)
-
kicad10-mcp
Developer Tools
tureruygar-glitch
A
license
Not graded
quality
B
maintenance
An MCP server providing full control over KiCad 10, enabling PCB editing, schematic editing, design data, and production output via natural language.
Updated 3 months ago (2026-06-21 13:11 UTC)
MIT
kicad-mcp
Developer Tools Embedded system
AbdulAzeez0001
A
license
Not graded
quality
C
maintenance
An MCP server that gives AI agents end-to-end control of KiCad 9+ for rule checks, manufacturing exports, production-readiness certification, and live PCB editor control.
Updated a month ago (2026-07-29 21:04 UTC)
MIT