MCP KiCAD Schematic API

Model Context Protocol (MCP) server providing KiCAD schematic manipulation tools for AI agents.

Overview

This MCP server exposes the kicad-sch-api library as tools that AI agents can use to create, modify, and analyze KiCAD schematic files.

Features

• 🔧 Create Schematics: Generate new KiCAD schematic files

• ⚡ Add Components: Place resistors, capacitors, ICs, and more

• 🔍 Search Components: Find parts in KiCAD symbol libraries

• 🔗 Add Connections: Create wires and nets

• 📐 Hierarchical Design: Support for hierarchical sheets and labels

• 🎯 Format Preservation: Maintains exact KiCAD file format compatibility

Quick Start

Installation

pip install mcp-kicad-sch-api

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kicad-sch-api": {
      "command": "python",
      "args": ["-m", "mcp_kicad_sch_api"],
      "env": {}
    }
  }
}

Claude Code

Option 1: Automatic (Recommended)

# Add MCP server automatically
claude mcp add mcp-kicad-sch-api /path/to/your/venv/bin/mcp-kicad-sch-api

# Example with specific venv path:
claude mcp add mcp-kicad-sch-api /Users/username/myproject/venv/bin/mcp-kicad-sch-api

Option 2: Manual Configuration If the automatic method doesn't work, manually edit your Claude Code config file:

# Find your config file location
code ~/.claude.json

Add the MCP server configuration:

{
  "mcpServers": {
    "mcp-kicad-sch-api": {
      "command": "/path/to/your/venv/bin/mcp-kicad-sch-api"
    }
  }
}

Finding Your Installation Path:

# After installing in your venv, find the executable path:
which mcp-kicad-sch-api
# Example output: /Users/username/myproject/venv/bin/mcp-kicad-sch-api

Restart Claude Code after configuration to load the MCP server.

Other MCP Clients

The server supports standard MCP stdio transport and should work with any MCP-compatible client.

Usage Examples

Ask your AI agent:

• "Create a voltage divider circuit with two 10kΩ resistors"

• "Add an Arduino Nano to the schematic at position (100, 100)"

• "Search for operational amplifiers in the KiCAD libraries"

• "Create a hierarchical sheet for the power supply section"

Tools Available

Requirements

• Python 3.10+

• KiCAD (for symbol libraries)

• kicad-sch-api library

Development

git clone https://github.com/circuit-synth/mcp-kicad-sch-api.git
cd mcp-kicad-sch-api
uv sync --dev
uv run python -m mcp_kicad_sch_api

License

MIT License - see LICENSE file.

Related Projects

• kicad-sch-api - Core Python library

• circuit-synth - AI-powered circuit design platform

🤖 AI-Powered Circuit Design Made Easy