openbci-mcp
The openbci-mcp server provides a comprehensive platform for interfacing with OpenBCI EEG/BCI hardware via BrainFlow. It enables hardware management, real-time data streaming, signal processing, data export, neurofeedback via OSC triggers, a web dashboard, agentic workflow automation, and built-in help.
Hardware Management: Connect, disconnect, and monitor OpenBCI boards (Cyton via serial/USB, Ganglion via BLE, Galea, synthetic, or streaming modes). List available serial ports and board types, check connection status.
Data Streaming: Start/stop EEG streaming into a ring buffer, take snapshots of latest samples per channel, and insert timestamped event markers (e.g., for P300/speller experiments).
Signal Processing: Compute real-time band powers (delta, theta, alpha, beta, gamma) per channel. Apply filters: bandpass, lowpass, highpass, or notch (including 60 Hz).
Data Export: Record live EEG to CSV files via BrainFlow's file streamer, or forward data to multicast addresses for OpenBCI GUI or custom applications. Supports custom BrainFlow streamer configurations.
OSC Triggers & Neurofeedback: Send one-shot OSC messages to targets like VRChat, Reaper, or osc-mcp. Create persistent threshold-based rules that automatically fire OSC messages when band power conditions are met. Manage rules (list, remove, evaluate) and review firing history.
Web Dashboard: Access a live web dashboard showing EEG traces and band power visualizations, along with integrated help documentation.
Agentic Workflows: Define multi-step BCI workflows in natural language; the server automatically chains available tools using FastMCP sampling to perform complex tasks (e.g., connect board, start stream, compute band power).
Help & Discovery: Built-in tool provides an overview of all tools, quickstart guides, fleet port assignments (frontend: 10758, backend: 10759), and hardware setup instructions.
Integration with VRChat via OSC protocol for sending trigger rules based on EEG data, allowing real-time avatar control or interactions driven by brain signals.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@openbci-mcpconnect to Cyton on COM3 and start streaming"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
openbci-mcp
FastMCP 3.2 MCP server and web dashboard for OpenBCI hardware via BrainFlow.
Features
Portmanteau MCP tools: board connect, stream, signal processing, export
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
Related MCP server: Buddy MCP Server
Quick start
cd D:\Dev\repos\openbci-mcp
.\start.batOr stdio for Claude Desktop:
uv sync
uv run openbci-mcp --stdioHardware (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 |
| 10759 | Backend port |
| (empty) | Default COM port |
| 0 | BrainFlow board id hint |
| 0 | Run synthetic probe at startup |
| 127.0.0.1 | Default OSC trigger target |
| 9000 | Default OSC UDP port (osc-mcp / VRChat) |
| ~/.openbci-mcp/triggers.json | Persisted trigger rules |
Documentation
Guide | Topic |
Master index — pick your path | |
Helmet, cap, superbike look, cable routing | |
Alpha, zen, focus meters | |
Mouse, P300, motor imagery, AI reality check | |
OSC, Resonite, streaming, stage | |
Wristbands, clench gating, fusion | |
osc-mcp pairing |
Webapp Help page (http://127.0.0.1:10758/help) loads these via /api/help.
Links
OSC integration (osc-mcp pairing)
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceMCP server for BusPirate 6 hardware security testing. Exposes UART, SPI, I2C, 1-Wire, power supply, GPIO, and logic analyzer operations as tools.Last updated2MIT
- Alicense-qualityDmaintenanceMCP server for controlling compatible boards over Bluetooth serial, including DC motors, servos, IO, and sensors.Last updatedMIT
- Alicense-qualityDmaintenanceAn MCP server for Gaggiuino-modified espresso machines, enabling monitoring, shot analysis, and profile management.Last updated81MIT
- Flicense-qualityDmaintenanceMCP server for controlling MicroPython devices (ESP32, RP2040, etc.) via USB Serial or WebREPL, enabling code execution, file operations, and device management from MCP clients.Last updated8
Related MCP Connectors
MCP server for interacting with the Supabase platform
MCP server for Producer/Riffusion AI music generation
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/openbci-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server