Happy slice of mcp pizzaMCP.pizza

kicad-mcp

MCP.Pizza Chef: lamaalrajih

Your assistant can list the KiCad projects on your computer, run design rule checks and track violations over time, put together a parts list, describe which components connect to what, spot common circuit patterns, and render a picture of a board. Getting there is hands-on: clone the repository, install its Python packages, and point your app at the folder. Nothing has been committed for about ten months, so expect it to lag behind newer KiCad releases.

Unmaintained · no commits since October 2025
Data
Other

Use This MCP server To

List every KiCad project I worked on recently Check my board for design rule violations Put together a parts list for this project See which components connect to the microcontroller Get a picture of my board layout in chat

README

KiCad MCP Server

This guide will help you set up a Model Context Protocol (MCP) server for KiCad. While the examples in this guide often reference Claude Desktop, the server is compatible with any MCP-compliant client. You can use it with Claude Desktop, your own custom MCP clients, or any other application that implements the Model Context Protocol.

Table of Contents

Prerequisites

  • macOS, Windows, or Linux
  • Python 3.10 or higher
  • KiCad 9.0 or higher
  • uv 0.8.0 or higher
  • Claude Desktop (or another MCP client)

Installation Steps

1. Set Up Your Python Environment

First, let's install dependencies and set up our environment:

# Clone the repository
git clone https://github.com/lamaalrajih/kicad-mcp.git
cd kicad-mcp

# Install dependencies – `uv` will create a `.venv/` folder automatically
# (Install `uv` first: `brew install uv` on macOS or `pipx install uv`)
make install

# Optional: activate the environment for manual commands
source .venv/bin/activate

2. Configure Your Environment

Create a .env file to customize where the server looks for your KiCad projects:

kicad-mcp FAQ

Is this still maintained?
No. The last commit was October 2025, roughly ten months ago. It still runs, but nothing has been fixed or updated since.
Which apps does it work in?
Claude Desktop is the documented example, and any other app that supports MCP servers should work.
Do I need a paid key?
No. It is free and reads the project files already on your own computer.
Can I use this to run a design rule check by just asking?
Yes. It runs the check through KiCad's own command line tool and can compare results to earlier runs.
How hard is setup?
Hands-on. You need Python 3.10 or newer, the uv tool, a copy of the repository, and an edited settings file.
Does KiCad need to be installed?
Yes, version 9.0 or newer, on the same machine, since it works against your local project files.