Mcp Kicad

io.github.daedalusPublished by GitHub account daedalusv0.1.1Updated Oct 25, 2026

MCP server exposing KiCad PCB Editor functionality via IPC API

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

A local MCP server that connects an assistant to a running KiCad 9 PCB Editor over its IPC API to inspect boards, footprints, nets and other design data.

What you can do
Connect to a running KiCad instance and check the connection status, project and version information, and board design settings and layers. List and search footprints, and read individual footprint details. List nets and netclasses, and read individual net details. List zones, tracks, vias, pads and text items, including text extents.
When to use it
Useful when you want an assistant to read and summarize the contents of an open KiCad PCB design, such as checking footprints, nets, layers or board settings, without exporting files by hand.
Requirements
Runs as a local process installed from PyPI (pip install mcp-kicad). Requires KiCad 9.0 or higher with the IPC API server enabled in KiCad's Preferences under Plugins, and KiCad must be running before the server starts. No authentication, environment variables or headers are declared.
Before you install
The server talks to a live KiCad instance, so it depends on KiCad being open with the API server enabled. The listed tools appear to be read-only inspection tools, but confirm this before relying on it with important designs.

Installation

In SourceWeft

  1. Open Mcp Kicad in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-kicad — MCP server exposing KiCad PCB Editor functionality via IPC API.

[PyPI] [Python] [Ruff]

Install

bash
pip install mcp-kicad

Requirements

  • KiCad 9.0 or higher with the IPC API server enabled
  • Go to Preferences > Plugins in KiCad and enable the API server

Usage

The MCP server communicates with a running KiCad instance via the IPC API. Start KiCad first, then run the server:

bash
mcp-kicad

Or configure it in your MCP client:

json
{  "mcpServers": {    "mcp-kicad": {      "command": "mcp-kicad",      "env": {}    }  }}

Tools

The server exposes the following tools:

  • Connection: connect_kicad, check_connection
  • Board: get_board_info, get_layers, get_board_design_settings
  • Footprints: list_footprints, get_footprint, search_footprints
  • Nets: list_nets, get_net, list_netclasses
  • Zones: list_zones
  • Tracks/Vias: list_tracks, list_vias
  • Pads: list_pads
  • Text: list_texts, get_text_extents
  • Project: get_project, get_version

Example

python
from mcp_kicad import mcp_server
# Connect to running KiCadresult = mcp_server.connect_kicad()
# Get board infoboard_info = mcp_server.get_board_info()print(board_info)
# List all footprintsfootprints = mcp_server.list_footprints()for fp in footprints:    print(f"{fp['reference']}: {fp['value']}")

Development

bash
git clone https://github.com/daedalus/mcp-kicad.gitcd mcp-kicadpip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

mcp-name: io.github.daedalus/mcp-kicad

Source: README.md at commit a2ee84c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts