Arduino MCP Server
Arduino MCP server for CLI setup, board detection, compile/upload, serial monitoring, and pin refs.
Ask AI about Arduino MCP Server
Powered by Claude · Grounded in docs
I know everything about Arduino MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Arduino MCP Server
Arduino MCP server for arduino-cli workflows: dependency checks/install, hardware detection, compile/upload, serial monitoring, board reference lookup, and safety preflight checks.
This repository includes:
server.jsonfor MCP Registry metadata.manifest.jsonfor Claude Desktop MCP bundle (.mcpb) packaging.
Description
Use this server to automate Arduino setup and development tasks from an MCP client while keeping operations local to your machine.
Features
- Arduino CLI dependency diagnosis and guided installation
- Board/port detection with FQBN inference
- Core installation checks and optional auto-install
- Sketch compile/upload workflows
- Upload-and-wait serial readiness flow
- Stateful serial sessions (
open,read,expect,write,close) - Electrical safety preflight checks
- Board reference resource and setup prompts
Requirements
- Node.js 20+
arduino-clionPATH, or install/configure it through provided tools
Installation
Install from npm:
npm install -g arduino-mcp-server
Add to 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"
}
}
}
}
Configuration
ARDUINO_CLI_PATH: Arduino CLI command/path (default:arduino-cli)ARDUINO_SKETCH_ROOT: optional absolute root restricting sketch compile/upload paths
Usage Examples
Example 1: Bootstrap missing Arduino CLI
User prompt:
Check if Arduino CLI is installed and install it automatically if missing.
Expected tool sequence:
arduino_cli_doctorinstall_arduino_cli(when missing)arduino_cli_doctor(re-check)
Example 2: Compile and upload a sketch
User prompt:
Compile D:/Projects/arduino-sketches/Blink for arduino:avr:uno and upload it to COM6.
Expected tool sequence:
compile_sketchwith sketch path + fqbnupload_sketchwith sketch path + fqbn + port
Example 3: Open serial monitor session and wait for ready text
User prompt:
Open serial on COM6 at 115200 and wait until the device prints READY.
Expected tool sequence:
serial_open_sessionserial_expectserial_read(optional for additional output)serial_close_session(when done)
Example 4: Safety preflight before writing to device
User prompt:
Before sending commands over serial, run a safety preflight for an Arduino Uno with my wiring details.
Expected tool sequence:
safety_preflightserial_writeonly if preflight does not block
MCP Surface
Tools:
arduino_cli_doctorinstall_arduino_clidetect_hardwareensure_core_installedcompile_sketchupload_sketchupload_and_wait_readyread_serial_snapshotsafety_preflightserial_open_sessionserial_list_sessionsserial_readserial_expectserial_writeserial_close_sessionlist_connected_boardslist_supported_boardslist_serial_portsget_board_detailslist_board_referencesearch_board_reference
Resources:
arduino://boards/reference
Prompts:
arduino-cli-bootstrap-policyarduino-setup-assistant
MCP Bundle (MCPB)
Build and package:
npm run build
npm run mcpb:validate
npm run mcpb:pack
Notes:
manifest.jsonis consumed bymcpb..mcpbignoreexcludes dev/reference files from bundle packaging.- Bundle output is written as
<name>.mcpbin the current directory by default.
Privacy Policy
- Policy URL: https://github.com/akshatnerella/arduino-mcp-server/blob/main/PRIVACY.md
- Local copy: PRIVACY.md
Summary:
- No built-in telemetry or analytics.
- Operations are local unless you explicitly invoke tooling that downloads dependencies.
- Data handling by your MCP host application is governed by that host's policies.
Support
- GitHub Issues: https://github.com/akshatnerella/arduino-mcp-server/issues
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
mainmust come fromrelease/*branches. - PRs must include exactly one bump label:
patch,minor, ormajor.
License
MIT, see LICENSE.
