Skip to content
MCP server

Altium Designer MCP

Let an AI assistant create and edit Altium footprint and symbol libraries

Runs locally
Install
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.4.0
Listing updated
4 days ago

Similar MCP servers

About Altium Designer MCP

Altium Designer MCP is an MCP server for engineering simulation. It runs locally on your machine and is started by your AI client.

Altium's .PcbLib and .SchLib files use an undocumented binary format that language models cannot write without corrupting it. This server takes over the file handling so the assistant can concentrate on the engineering: reading a datasheet, applying IPC-7351B pad sizes, choosing courtyards and silkscreen, and deciding what primitives to place. The README says that split is the point, and that it works for any component, not a fixed set of package generators.

The README counts 34 tools across reading and writing libraries, listing and searching components, previewing footprints and symbols as ASCII art, extracting styling from an existing library, comparing libraries and components, editing pads and primitives in place, batch updates, reordering, managing schematic parameters and footprint links, and deleting, copying or renaming components. STEP model attachment is also handled by the server.

It is for people who already design in Altium and use an MCP client. Client setup guides cover Claude Code, Claude Desktop, Cursor, VS Code and many others on Windows, Linux and macOS. It runs over stdio and is also published as an mcpb bundle.

Install

Run in a terminal

claude mcp add altium-designer-mcp -- npx -y https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "altium-designer-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (23)

Taken from the project documentation; the running server may differ.

read_pcblib
Reads footprints from a .PcbLib.
write_pcblib
Writes footprints to a .PcbLib.
read_schlib
Reads symbols from a .SchLib.
write_schlib
Writes symbols to a .SchLib.
list_components
Lists component names, paginated.
get_component
Returns one component's full data.
search_components
Searches libraries by regex or glob.
component_exists
Checks whether components exist.
render_footprint
ASCII-art preview of a footprint.
render_symbol
ASCII-art preview of a symbol.
extract_style
Extracts styling from an existing library.
diff_libraries
Compares two library files.
compare_components
Diffs two components.
update_component
Updates a component, keeping its position.
update_pad
Updates one pad's properties.
update_primitive
Updates one primitive.
batch_update
Applies updates across all components.
reorder_components
Reorders components in a library.
manage_schlib_parameters
Lists, gets, sets or removes SchLib parameters.
manage_schlib_footprints
Manages footprint links in SchLib symbols.
delete_component
Deletes components.
copy_component
Duplicates a component within a library.
rename_component
Renames a component.

What it does

Read and write libraries
Handles .PcbLib footprint and .SchLib symbol files safely.
Primitive placement
Places pads, tracks, arcs, text, fills and regions chosen by the AI.
ASCII previews
Renders footprints and symbols as text for quick checks.
Style extraction
Copies the styling of an existing library for new parts.
Library comparison
Diffs two libraries or two components.
In-place edits
Updates pads and primitives or applies batch changes.
Component management
Copies, renames, deletes and reorders components.

Good for

  • Generate a footprint for a new package from datasheet dimensions
  • Create a matching schematic symbol and link it to the footprint
  • Apply one style change across every component in a library
  • Diff two versions of a footprint library
  • Search a library for components by pattern

Altium Designer MCP FAQ

What file types does it handle?

Altium Designer .PcbLib footprint and .SchLib symbol libraries.

Who does the engineering?

The AI does IPC-7351B calculations and layout decisions; the server reads, writes and places primitives.

How many tools are there?

The README says 34.

Which clients are supported?

Any stdio MCP client, with guides for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed and more.

Do I need Altium?

Yes, the README says it is not for people who do not use Altium.

How do I add Altium Designer MCP to Claude Code?

Run this command in your terminal: claude mcp add altium-designer-mcp -- npx -y https://github.com/embedded-society/altium-designer-mcp/releases/download/v1.4.0/altium-designer-mcp.mcpb

What are the best alternatives to Altium Designer MCP?

The closest alternatives to Altium Designer MCP are Copper-KiCad, MCP, PCBBrew, Network Sketcher (Local MCP) and Autonomous 0-DRC PCB Routing Foundry & Hardware MCP Server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers