Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Openbci

FreeNot checked

MCP server for OpenBCI hardware via BrainFlow, enabling board connection, streaming, signal processing, and export with a web dashboard.

GitHubEmbed

About

MCP server for OpenBCI hardware via BrainFlow, enabling board connection, streaming, signal processing, and export with a web dashboard.

README

FastMCP MCP server and web dashboard for OpenBCI hardware via BrainFlow.

Stack

Python 3.12+ (uv), FastMCP >=3.4.4,<4, Starlette REST + WebSocket backend, React 19 + Vite + TailwindCSS + react-router dashboard (web_sota/), Tauri 2 native shell (native/).

Features

  • Portmanteau MCP tools: board connect, stream, signal processing, export, OSC triggers, shutdown
  • Machine-readable board capabilities: openbci://boards/capabilities resource
  • Prompt templates: openbci-quickstart, openbci-osc-recipe
  • REST + WebSocket dashboard with live EEG trace and band power
  • Cyton (serial), Ganglion (BLE), Galea, synthetic, and GUI streaming board modes
  • Fleet ports: frontend 10758, backend 10759

Tool table

Tool Operations
openbci_board connect, disconnect, status, list_ports, list_boards, probe
openbci_stream start, stop, snapshot, marker
openbci_signal band_power, filter
openbci_export streamer_add, streamer_file, streamer_multicast
openbci_trigger send_osc, list_rules, add_rule, remove_rule, evaluate, history, fire_test
agentic_openbci_workflow multi-step sampling workflow
openbci_help overview, quickstart, ports
openbci_shutdown graceful shutdown

Every tool returns {success, message, ...}. Trigger timing is a fixed 10 Hz hop — see OSC integration.

Quick start

cd D:\Dev\repos\openbci-mcp
.\start.bat

Or stdio for Claude Desktop:

uv sync
uv run openbci-mcp --stdio

New here? Read docs/ONBOARDING.md — synthetic probe to live EEG in 10 minutes.

Claude Desktop config

{
  "mcpServers": {
    "openbci": {
      "command": "uv",
      "args": ["run", "--project", "D:\\Dev\\repos\\openbci-mcp", "openbci-mcp", "--stdio"]
    }
  }
}

Hardware (Cyton)

  1. Plug in USB dongle, note COM port (Device Manager or openbci_board(operation='list_ports'))
  2. Close OpenBCI GUI if it holds the serial port
  3. Connect: openbci_board(operation='connect', board_key='cyton', serial_port='COM3')
  4. openbci_stream(operation='start')

Environment

Variable Default Description
OPENBCI_MCP_HOST 127.0.0.1 Backend bind
OPENBCI_MCP_PORT 10759 Backend port
OPENBCI_SERIAL_PORT (empty) Default COM port
OPENBCI_BOARD_ID 0 BrainFlow board id hint
OPENBCI_PROBE 0 Run synthetic probe at startup
OPENBCI_OSC_HOST 127.0.0.1 Default OSC trigger target
OPENBCI_OSC_PORT 9000 Default OSC UDP port (osc-mcp / VRChat)
OPENBCI_TRIGGERS_FILE ~/.openbci-mcp/triggers.json Persisted trigger rules

Ports

Backend 10759 (REST + MCP HTTP /mcp + WebSocket), frontend 10758. OSC out 127.0.0.1:9000.

Documentation

Guide Topic
Onboarding First run, synthetic probe, pitfalls
Usage scenarios Master index — pick your path
Wearable styling Helmet, cap, superbike look, cable routing
Neurofeedback Alpha, zen, focus meters
BCI control Mouse, P300, motor imagery, AI reality check
VR and creative OSC, Resonite, streaming, stage
Hybrid EMG + EEG Wristbands, clench gating, fusion
OSC integration osc-mcp pairing + trigger timing

Webapp Help page (http://127.0.0.1:10758/help) loads these via /api/help.

Links

from github.com/sandraschi/openbci-mcp

Installing Openbci

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/openbci-mcp

FAQ

Is Openbci MCP free?

Yes, Openbci MCP is free — one-click install via Unyly at no cost.

Does Openbci need an API key?

No, Openbci runs without API keys or environment variables.

Is Openbci hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Openbci in Claude Desktop, Claude Code or Cursor?

Open Openbci on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Openbci with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs