Openbci
FreeNot checkedMCP server for OpenBCI hardware via BrainFlow, enabling board connection, streaming, signal processing, and export with a web dashboard.
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/capabilitiesresource - 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)
- Plug in USB dongle, note COM port (Device Manager or
openbci_board(operation='list_ports')) - Close OpenBCI GUI if it holds the serial port
- Connect:
openbci_board(operation='connect', board_key='cyton', serial_port='COM3') 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
- OpenBCI
- BrainFlow docs
- OpenBCI GUI
- OSC integration (osc-mcp pairing)
- Changelog
Installing Openbci
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/openbci-mcpFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare Openbci with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
