Arduino

v1.0.0Developer Toolsstable

Enables interaction with Arduino development through arduino-cli, allowing sketch management, code compilation and uploading, library and board operations, serial monitoring, and AI-powered circuit diagram generation using WireViz.

mcp-arduinomcpai-integration
Share:
11
Stars
0
Downloads
0
Weekly
0/5

What is Arduino?

Arduino is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with arduino development through arduino-cli, allowing sketch management, code compilation and uploading, library and board operations, serial monitoring, and ai-powered circuit di...

Enables interaction with Arduino development through arduino-cli, allowing sketch management, code compilation and uploading, library and board operations, serial monitoring, and AI-powered circuit diagram generation using WireViz.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with Arduino development through arduino

Use Cases

Manage Arduino sketches, compile, and upload with AI.
Generate circuit diagrams using AI and WireViz.
Volt23

Maintainer

LicenseNOASSERTION
Languagepython
Versionv1.0.0
UpdatedApr 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-arduino

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Arduino

MCP Arduino Server bridges AI assistants with the Arduino development ecosystem via arduino-cli, enabling natural-language sketch creation, compilation, and uploading, library and board management, serial port monitoring, and AI-powered circuit diagram generation using WireViz — all from within MCP-compatible clients like Claude Desktop.

Prerequisites

  • Python 3.10 or later installed
  • arduino-cli installed and available on PATH (https://arduino.github.io/arduino-cli/)
  • An MCP-compatible client such as Claude Desktop
  • Optional: WireViz installed for AI circuit diagram generation
  • Optional: OpenAI or OpenRouter API key for AI-powered diagram generation
1

Install arduino-cli

Install the Arduino CLI tool which the MCP server uses to manage boards, libraries, and sketch compilation.

# macOS with Homebrew
brew install arduino-cli

# Linux / Windows (curl installer)
curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh

# Verify installation
arduino-cli version
2

Install the MCP Arduino server from PyPI

Install the mcp-arduino-server package using pip.

pip install mcp-arduino-server
3

Configure Claude Desktop

Add the MCP Arduino server to your claude_desktop_config.json. Supply optional environment variables for the arduino-cli path, sketch directory, and AI diagram generation keys.

{
  "mcpServers": {
    "mcp-arduino": {
      "command": "mcp-arduino-server",
      "args": [],
      "env": {
        "ARDUINO_CLI_PATH": "arduino-cli",
        "MCP_SKETCH_DIR": "/Users/yourname/Documents/Arduino_MCP_Sketches",
        "LOG_LEVEL": "INFO",
        "OPENAI_API_KEY": "sk-your-key-here"
      }
    }
  }
}
4

Install board cores and libraries via Claude

Once connected, ask Claude to install the board core for your Arduino board and any libraries needed for your project.

5

Connect your Arduino and start developing

Plug in your Arduino board via USB, ask Claude to list available boards and ports, then create and upload sketches through natural-language commands.

Arduino Examples

Client configuration

claude_desktop_config.json entry for the MCP Arduino server installed via pip, with OpenAI key for circuit diagram generation.

{
  "mcpServers": {
    "mcp-arduino": {
      "command": "mcp-arduino-server",
      "args": [],
      "env": {
        "ARDUINO_CLI_PATH": "arduino-cli",
        "MCP_SKETCH_DIR": "/Users/yourname/Documents/Arduino_MCP_Sketches",
        "LOG_LEVEL": "INFO",
        "OPENAI_API_KEY": "sk-your-openai-key"
      }
    }
  }
}

Prompts to try

Example natural-language prompts to use with the MCP Arduino server in Claude Desktop.

- "Create a new Arduino sketch that blinks the onboard LED every 500ms and upload it to my Uno on /dev/cu.usbmodem14101"
- "Search for and install the Adafruit NeoPixel library"
- "List all connected Arduino boards and their port names"
- "Read the last 50 lines from the serial monitor on /dev/cu.usbmodem14101 at 9600 baud"
- "Generate a circuit diagram for an Arduino Uno connected to a DHT22 temperature sensor and an I2C LCD display"
- "Verify my sketch compiles correctly for the Arduino Mega 2560 board"

Troubleshooting Arduino

arduino-cli not found when the server starts

Ensure arduino-cli is installed and on your system PATH. Set ARDUINO_CLI_PATH to the full path of the binary (e.g., /usr/local/bin/arduino-cli) in the env block of your config if the default PATH lookup fails.

Sketch upload fails with 'device not found' error

Verify your Arduino is connected via USB and the correct port is specified. Use the list_boards tool to discover available ports. On macOS, the port is typically /dev/cu.usbmodem* and on Linux /dev/ttyACM0 or /dev/ttyUSB0.

Circuit diagram generation fails

Ensure WireViz is installed (pip install wireviz) and the WIREVIZ_PATH environment variable points to the wireviz binary. Also confirm OPENAI_API_KEY or OPENROUTER_API_KEY is set correctly for the AI description-to-diagram step.

Frequently Asked Questions about Arduino

What is Arduino?

Arduino is a Model Context Protocol (MCP) server that enables interaction with arduino development through arduino-cli, allowing sketch management, code compilation and uploading, library and board operations, serial monitoring, and ai-powered circuit diagram generation using wireviz. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Arduino?

Follow the installation instructions on the Arduino GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Arduino?

Arduino works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Arduino free to use?

Yes, Arduino is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-arduino": { "command": "npx", "args": ["-y", "mcp-arduino"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Arduino?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides