Arduino MCP Server

io.github.akshatnerellaPublished by GitHub account akshatnerellav0.2.7Updated Nov 10, 2026

Arduino MCP server for CLI setup, board detection, compile/upload, serial monitoring, and pin refs.

VerifiedSTDIODesktop onlyDeveloper Tools Security & Monitoring

Server details

Identifier: io.github.akshatnerella/arduino-mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account akshatnerella for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.akshatnerella%2Farduino-mcp-server.svg)](https://sourceweft.com/mcp/io.github.akshatnerella%2Farduino-mcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Wraps arduino-cli so an assistant can detect boards, compile and upload sketches, monitor serial output, and run wiring safety checks.

What you can do: Check and install arduino-cli, install board cores and libraries
Detect connected boards, serial ports and board pin references
Compile sketches and upload them to a target board, optionally waiting for a ready signal
Open, read, expect, write and close stateful serial sessions, or take one-shot serial snapshots
Run electrical safety preflight checks and look up board capabilities
When to use it: Useful when you work with Arduino hardware and want an assistant to handle the compile-upload-monitor loop, set up a toolchain from scratch, or sanity-check voltage and current before sending commands to a board.
Requirements: Runs locally over stdio as an npm package (arduino-mcp-server), typically via npx in a desktop client. Needs arduino-cli on the PATH or the ARDUINO_CLI_PATH variable pointing to it; the server can also guide installation. ARDUINO_SKETCH_ROOT optionally restricts sketch operations to one directory. A connected board and USB serial access are needed for upload and monitoring.

Before you install

Uploading sketches writes firmware to connected hardware, and serial_write sends data to the device, so actions can change physical state. Safety preflight is advisory only and does not guarantee correct wiring. Installing arduino-cli, cores or libraries downloads software from third parties. Set ARDUINO_SKETCH_ROOT to limit which sketch directories the assistant can touch.

Installation

In SourceWeft

Open Arduino MCP Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

arduino-mcp-server

[npm version] [License: MIT] [Node.js 20+]

Give your AI assistant full control over Arduino — compile, upload, monitor serial, and verify wiring safety, all through natural language.

Part of the HardwareMCP ecosystem — open-source MCP servers that bridge AI to physical hardware.

What this does

AI assistants can control Jira, GitHub, and databases. They can't talk to a microcontroller — until now.

arduino-mcp-server wraps arduino-cli into an MCP server so your AI can:

Detect connected boards and ports automatically
Compile and upload sketches without touching the terminal
Monitor serial output with stateful sessions (open, read, expect, write, close)
Run electrical safety checks before sending commands to hardware
Manage dependencies — cores, libraries, and CLI installation

Quick Start

Install:

Add to Claude Desktop (claude_desktop_config.json):

json

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

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

Requires arduino-cli on your PATH, or let the server install it for you.

What you can say

Bootstrap from scratch:

"Check if Arduino CLI is installed and set everything up for an Arduino Uno."

Compile and upload:

"Compile my Blink sketch and upload it to the Uno on COM6."

Serial monitoring:

"Open serial on COM6 at 115200 and wait until the device prints READY."

Safety-first workflows:

"Run a safety preflight for an Arduino Uno with 5V on pin 13 at 25mA before I send commands."

Tools

Tool	What it does
`arduino_cli_doctor`	Check Arduino CLI installation and version
`install_arduino_cli`	Guide through arduino-cli installation
`detect_hardware`	Detect connected boards and infer FQBNs
`list_connected_boards`	List all connected Arduino boards
`list_serial_ports`	List available serial ports
`ensure_core_installed`	Check/install board cores
`compile_sketch`	Compile a sketch for a target board
`upload_sketch`	Upload compiled sketch to a board
`upload_and_wait_ready`	Upload and wait for device ready signal
`serial_open_session`	Open a stateful serial session
`serial_read`	Read buffered serial data
`serial_expect`	Wait for a pattern in serial output
`serial_write`	Send data over serial
`serial_close_session`	Close a serial session
`serial_list_sessions`	List active serial sessions
`read_serial_snapshot`	Quick one-shot serial read
`safety_preflight`	Electrical safety check before hardware ops
`get_board_details`	Get pin/capability details for a board
`list_supported_boards`	List all boards arduino-cli supports
`list_board_reference`	Browse board pin reference
`search_board_reference`	Search board reference by keyword

Resources:

arduino://boards/reference — structured board pin/capability reference

Prompts:

arduino-cli-bootstrap-policy — policy for arduino-cli setup behavior
arduino-setup-assistant — guided Arduino environment setup

Configuration

Development

bash

git clone https://github.com/hardware-mcp/arduino-mcp-servercd arduino-mcp-servernpm installnpm run typechecknpm run buildnpm run dev

git clone https://github.com/hardware-mcp/arduino-mcp-servercd arduino-mcp-servernpm installnpm run typechecknpm run buildnpm run dev

Part of HardwareMCP

This server is part of the HardwareMCP ecosystem — a collection of MCP servers that give AI assistants real control over physical hardware.

License

MIT — see LICENSE.

Support

Open an issue

Source: README.md at commit 37ea038

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Variable	Default	Description
`ARDUINO_CLI_PATH`	`arduino-cli`	Path to arduino-cli binary
`ARDUINO_SKETCH_ROOT`	(none)	Restrict sketch paths to this directory