Arduino MCP Server

Arduino MCP server for arduino-cli workflows: dependency checks/install, hardware detection, compile/upload, serial monitoring, and board reference lookup.

Quick Start

Install globally:

npm install -g arduino-mcp-server

Add to your AI agent MCP config.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "arduino": {
      "command": "npx",
      "args": ["-y", "arduino-mcp-server"],
      "env": {
        "ARDUINO_CLI_PATH": "arduino-cli",
        "ARDUINO_SKETCH_ROOT": "D:/Projects/arduino-sketches"
      }
    }
  }
}

Codex MCP config:

{
  "mcpServers": {
    "arduino": {
      "command": "npx",
      "args": ["-y", "arduino-mcp-server"],
      "env": {
        "ARDUINO_CLI_PATH": "arduino-cli",
        "ARDUINO_SKETCH_ROOT": "D:/Projects/arduino-sketches"
      }
    }
  }
}

Features

arduino_cli_doctor and install_arduino_cli for dependency bootstrap
detect_hardware with board/FQBN inference and user-confirmation guidance
ensure_core_installed with automatic core setup from FQBN
compile_sketch and upload_sketch with optional auto core install
Serial monitoring and board/port listing tools
Local board reference resource and setup prompts

Requirements

Node.js 20+
arduino-cli available on PATH (or let the server install it via tools)

Configuration

ARDUINO_CLI_PATH: Arduino CLI command/path (default: arduino-cli)
ARDUINO_SKETCH_ROOT: optional absolute root for sketch operations

MCP Surface

Tools:

arduino_cli_doctor
install_arduino_cli
detect_hardware
ensure_core_installed
compile_sketch
upload_sketch
read_serial_snapshot
list_connected_boards
list_supported_boards
list_serial_ports
get_board_details
list_board_reference
search_board_reference

Resources:

arduino://boards/reference

Prompts:

arduino-cli-bootstrap-policy
arduino-setup-assistant

Development

git clone https://github.com/akshatnerella/arduino-mcp-server
cd arduino-mcp-server
npm install
npm run typecheck
npm run build
npm run dev

Release

PRs into main must come from release/* branches.
PRs must include exactly one bump label: patch, minor, or major.

License

MIT, see LICENSE.

MCP Servers