Skip to content
MCP server

ESP-IDF MCP

Build, flash, monitor and test ESP-IDF firmware on real ESP32 boards from an agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, Linux
Runs
Locally
Version
1.1.0
Listing updated
today

Similar MCP servers

About ESP-IDF MCP

ESP-IDF MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

This community-built local server closes the loop for embedded work: an agent can compile an ESP-IDF project, flash a connected board over serial, capture the boot log and run pytest-embedded hardware tests, rather than only writing firmware code. Builds go through idf.py, so sdkconfig behaves as usual, and the ESP-IDF install is found automatically.

Its serial monitor is session based. monitor_open, monitor_read, monitor_send and monitor_close give a persistent session read for new lines only, with idle sessions releasing the port after 30 seconds by default, reconnection after USB re-enumeration, ANSI stripping, collapsing of repeated lines and folding of boot output before the app starts. Flashing opens a monitor automatically on the chosen port, and read_chip_info reports the chip model, revision, crystal, MAC and flash details.

The README compares it with Espressif's built-in Tools MCP server, noting that it adds component management, bundled examples, device sessions and hardware tests. The quick start targets Windows with Codex, and a board is only needed for flashing, monitoring and tests.

Install

Run in a terminal

claude mcp add esp-idf-mcp -- uvx esp-idf-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "esp-idf-mcp": {
      "command": "uvx",
      "args": [
        "esp-idf-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "esp-idf-mcp": {
      "command": "uvx",
      "args": [
        "esp-idf-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "esp-idf-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "esp-idf-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "esp-idf-mcp": {
      "command": "uvx",
      "args": [
        "esp-idf-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "esp-idf-mcp": {
      "command": "uvx",
      "args": [
        "esp-idf-mcp"
      ]
    }
  }
}

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

Tools this server provides (7)

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

build_project
Builds the project with idf.py
flash_project
Flashes the board and opens a monitor session
read_chip_info
Reports chip model, revision, crystal, MAC and flash details
monitor_open
Opens a persistent serial monitor session
monitor_read
Reads new lines from a monitor session
monitor_send
Sends data to a monitor session
monitor_close
Closes a monitor session

What it does

Build and flash
Compiles with idf.py and flashes via esptool in one workflow.
Persistent serial monitor
Sessions that return only new log lines, with a full-log escape hatch.
Chip info
Reads model, revision, crystal, MAC and flash size from the board.
Hardware-in-the-loop tests
Runs pytest-embedded suites against the real device.
Component management
Add or remove component dependencies and browse bundled examples.
Agent-friendly logs
Strips colours, collapses repeats and reports folded line counts.

Good for

  • Have an agent build and flash a firmware change then summarise the boot log
  • Run hardware tests after each code edit
  • Identify the chip and flash size of an unknown board
  • Debug a crash by polling the serial monitor
  • Scaffold a project from a bundled ESP-IDF example

Pricing

Open source

ESP-IDF MCP FAQ

What do I need installed?

ESP-IDF and Python 3.9 or newer; a board only for flashing, monitoring and hardware tests.

How is it installed?

The README shows pip install and adding it to Codex with codex mcp add esp-idf -- esp-idf-mcp.

Will it disturb other boards?

No, only the target port's monitor session is closed before flashing.

How does it differ from Espressif's built-in MCP?

The README says it adds persistent monitor sessions, chip details, component management, bundled examples and pytest-embedded tests.

Is ESP-IDF MCP free?

Yes. ESP-IDF MCP is open source, so you can use and self-host it for free.

How do I add ESP-IDF MCP to Claude Code?

Run this command in your terminal: claude mcp add esp-idf-mcp -- uvx esp-idf-mcp

What are the best alternatives to ESP-IDF MCP?

The closest alternatives to ESP-IDF MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

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

How AIPoweredBot checks servers