# Eeg MCP

> Eeg MCP is an open-source MCP server for health and science. Real-time EEG for agents: BrainFlow streaming, replay, recording and stimulation. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://aimplifier.github.io/eeg-mcp/
- **Repository:** https://github.com/aimplifier/eeg-mcp
- **MCP Registry name:** io.github.AImplifier/eeg-mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

This is the live-signal half of a pair: eeg-mcp handles everything that must happen while data is still arriving, and its sibling neuro-mcp covers offline MNE processing. It installs from PyPI and runs over stdio with 47 tools.

Acquisition covers 66 BrainFlow board identifiers (OpenBCI, Muse, ANT Neuro, g.tec, Mentalab) plus a synthetic board that needs no hardware; a background thread fills a ring buffer so tool calls read a live view. Existing EDF, BDF, GDF, SET or FIF files and BrainFlow CSVs can be replayed at their recorded rate with annotations re-emitted as events, so a pipeline built on a file runs unchanged against hardware.

Processing is stateful online filtering with band power, PSD and per-electrode quality, plus custom processors. A token-gated, loopback-only browser view shows live traces, and recording writes crash-safe .fif files. Stimulation goes through one send_stim_event contract over LSL, BrainFlow markers, serial or TTL, and TMS and tES protocols behind three safety gates.

## Features

- **66 board types:** BrainFlow boards plus a synthetic board for hardware-free work.
- **Wall-clock replay:** Plays recordings at original timing with speed, seek and looping.
- **Online DSP:** Stateful filters, band power, PSD and electrode quality.
- **Live browser monitor:** Loopback-bound, token-gated view of traces and event markers.
- **Crash-safe recording:** Continuous .fif files with the event log as annotations.
- **Gated stimulation:** Three safety gates sit in front of stimulation output.

## Good for

- Prototype a closed-loop BCI without hardware
- Replay a saved session to test a pipeline
- Monitor electrode quality during acquisition
- Record sessions for later MNE analysis
- Trigger software or hardware stimulation events

## Install

### Claude Code (Terminal)

```sh
claude mcp add eeg-mcp -- uvx eeg-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "eeg-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "eeg-mcp": {
      "command": "uvx",
      "args": [
        "eeg-mcp"
      ]
    }
  }
}
```

## Tools

- `send_stim_event`: Dispatches a stimulation event over LSL, BrainFlow markers, serial/TTL or templated TMS and tES protocols behind safety gates.

## FAQ

### How do I install it?

pip install eeg-mcp; it runs over stdio.

### Do I need EEG hardware?

No, a synthetic board is included.

### What is its offline counterpart?

neuro-mcp, which does MNE processing, source imaging and BIDS/EHR storage.

### Is the live view exposed to the network?

It is bound to loopback and token-gated.

### Is Eeg MCP free?

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

### How do I add Eeg MCP to Claude Code?

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

### What are the best alternatives to Eeg MCP?

The closest alternatives to Eeg MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/eeg-mcp
