Skip to main content
mcpSource-backedReview first Safety Privacy

KiCad MCP Server

MCP server for KiCad projects that lets Claude discover boards, inspect project structure, analyze PCB and schematic files, extract netlists, review BOMs, run design-rule workflows, and generate board thumbnails.

by Lama Al Rajih·added 2026-06-06·
Claude CodeClaude Desktop
HarnessClaude CodeClaude Desktop
Review first review before installing

Open the source and read safety notes before installing.

Safety notes

  • KiCad MCP can discover local projects, inspect design files, launch KiCad, run `kicad-cli`, and generate files such as PCB thumbnails.
  • Design-rule checks, netlists, BOMs, and pattern analysis are advisory and should be verified in KiCad and by qualified hardware reviewers.
  • Generated thumbnails and exports can write files into the project directory.
  • External CLI operations can fail, time out, or return stale results if KiCad, project paths, or environment variables are misconfigured.
  • Use approved project paths only and avoid broad search directories that expose unrelated designs.

Privacy notes

  • KiCad project paths, board layouts, schematics, netlists, BOMs, component choices, footprints, and DRC findings can reveal proprietary hardware design details.
  • The server logs runtime information locally and may include search paths, project names, and operation status.
  • Generated exports, thumbnails, temporary files, and model transcripts can contain sensitive design information.
  • Do not expose customer, regulated, unreleased, or export-controlled hardware designs unless the local environment and model workflow are approved.

Prerequisites

  • KiCad 9.0 or newer with `kicad-cli` available for CLI-backed operations.
  • Python 3.11 or newer for the current PyPI package, or a compatible source checkout following the README.
  • A configured set of approved KiCad project search paths.
  • Permission for the MCP client to read project files and run local KiCad CLI operations.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
25 minutes
Difficulty
intermediate
Full copyable content
{
  "mcpServers": {
    "kicad": {
      "command": "kicad-mcp",
      "env": {
        "KICAD_SEARCH_PATHS": ""
      }
    }
  }
}

About this resource

Content

KiCad MCP Server is a Model Context Protocol server for inspecting and working with local KiCad electronic design automation projects. It exposes resources, tools, and prompts for project discovery, file inspection, PCB and schematic analysis, netlist extraction, BOM review, design-rule checking, thumbnail generation, and circuit pattern recognition.

The server is useful when Claude needs project-aware context about an approved board design, but it should be treated as an assistant for review and analysis, not as a replacement for KiCad, electrical engineering review, manufacturing checks, or formal sign-off.

Source Review

These sources were reviewed on 2026-06-06. Prefer the live repository, README, PyPI metadata, package metadata, server implementation, configuration module, export tool implementation, and license file for current setup, supported KiCad versions, tool behavior, file outputs, and licensing.

Features

  • Python package kicad-mcp.
  • FastMCP server launched with the kicad-mcp console command or from source.
  • Project discovery through configured KiCad search paths.
  • Resources for projects, files, DRC data, BOM data, netlists, and circuit patterns.
  • Tools for project management, PCB analysis, exports, DRC workflows, BOM review, netlist extraction, and pattern recognition.
  • Prompt templates for PCB debugging, DRC review, BOM work, and pattern analysis.
  • KiCad CLI-backed thumbnail/export operations.
  • MIT license.

Installation

Install the package, configure approved KiCad search paths, then add the server to your MCP client:

pip install kicad-mcp
{
  "mcpServers": {
    "kicad": {
      "command": "kicad-mcp",
      "env": {
        "KICAD_SEARCH_PATHS": ""
      }
    }
  }
}

After restarting the MCP client, ask Claude to inspect an approved KiCad project, summarize board structure, review BOM data, or run a DRC-oriented workflow for human review.

Use Cases

  • List and identify local KiCad projects.
  • Explain the structure of a selected board project.
  • Summarize schematic, PCB, netlist, or BOM information.
  • Run a design-rule-check workflow and summarize findings.
  • Generate a board thumbnail for visual review.
  • Identify common circuit patterns in a schematic.
  • Ask Claude to prepare hardware-review questions from design artifacts.

Safety and Privacy

KiCad MCP works with local hardware design files and can run local KiCad CLI operations. Restrict KICAD_SEARCH_PATHS to approved project folders, verify results in KiCad, and keep human engineering review in the loop before acting on BOM, DRC, netlist, footprint, or manufacturing conclusions.

Hardware designs often contain sensitive intellectual property. Treat project paths, schematics, board layouts, BOMs, netlists, component selections, generated thumbnails, logs, and model transcripts as sensitive design data. Avoid exposing regulated, export-controlled, customer, or unreleased hardware unless the environment and model workflow are approved for that use.

Duplicate Check

Existing MCP content includes CAD, browser, and developer-tool integrations, but no dedicated entry for lamaalrajih/kicad-mcp or the kicad-mcp PyPI package was found in content/mcp. This entry is distinct because it covers local KiCad project discovery, PCB analysis, DRC, BOM, netlist, export, and circuit pattern workflows.

#kicad#pcb#electronics#hardware#eda

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.