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: @sentientui/mcp
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 controlling compatible boards over Bluetooth serial, including DC motors, servos, IO, and sensors.MIT
- Alicense-qualityBmaintenanceMCP server for SentientUI that gives AI agents in Claude Code, Cursor, and Copilot direct access to experiment data and management actions.856MIT
- AlicenseAqualityBmaintenanceA Model Context Protocol server that provides AI agents with a unified interface for real-time EEG acquisition, replay, processing, visualization, recording, and stimulation from over 66 BrainFlow boards.47BSD 3-Clause
- AlicenseAqualityAmaintenanceAn MCP server that gives AI assistants conversational access to MNE-Python for analyzing neurophysiology data (EEG, MEG, sEEG, ECoG, fNIRS). Enables plain-language analysis pipelines, from loading recordings to generating figures and explanations.397MIT
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