altium-monkey-mcp

Read-only MCP server that lets AI assistants (Claude Code, Claude Desktop, VS Code, ...) inspect Altium Designer projects — schematics, netlist, BOM and PCB — on Linux, macOS or Windows, without Altium Designer installed.

It is a thin wrapper around altium-monkey, which parses the binary .SchDoc / .PcbDoc / .PrjPcb formats directly.

Tools

project accepts a .PrjPcb (recommended), .SchDoc, .PcbDoc, or a directory containing a project. Parsed designs are cached in memory and reloaded when any design file changes. Coordinates are reported in mm.

Related MCP server: KiCad MCP Server

Requirements

• Python 3.12–3.14 (required by altium-monkey)

• Inkscape on PATH — optional, only for PNG output of the render tools

Installation

git clone https://github.com/wjakiela/altium-monkey-mcp.git
cd altium-monkey-mcp
uv venv --python 3.12
uv pip install -e .

Claude Code (available in all projects)

claude mcp add --scope user altium -- "$PWD/.venv/bin/altium-monkey-mcp"

Claude Desktop / other clients

{
  "mcpServers": {
    "altium": {
      "command": "/absolute/path/to/altium-monkey-mcp/.venv/bin/altium-monkey-mcp"
    }
  }
}

Example prompts

• "Which ESP32 pins are connected to the 32 kHz crystal, and what load capacitors are used?"

• "List all parts on net V_BAT and how long the trace is on each layer."

• "Render the bottom layer of the PCB and show me where Y1 sits."

• "What clearance and width rules does the board use?"

Limitations

• Read-only: the server never modifies design files.

• Accuracy depends on altium-monkey; Linux support there is less tested than Windows.

• Arc length is not included in routing length; polygons/planes are counted, not measured.

License

AGPL-3.0-or-later, because the project depends on altium-monkey (AGPL-3.0-or-later). Altium and Altium Designer are trademarks of Altium Limited; this project is not affiliated with Altium.