Ble Mcp Server
by es617communityv0.3.0
10
2
This MCP server implements a stateful Bluetooth Low Energy (BLE) Model Context Protocol (MCP) server that allows AI agents to interact with BLE devices for scanning, connecting, reading, and writing data. It supports multiple transport options and provides a set of tools for developers and testers.
From the registry: Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.
Install & configure
Prerequisites
- requiredInstall ble-mcp-serverInstall the Python package from PyPI. Python 3.11+ required.
https://pypi.org/project/ble-mcp-server/$ pip install ble-mcp-server
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `ble-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install ble-mcp-server** — Install the Python package from PyPI. Python 3.11+ required. Run: `pip install ble-mcp-server` (https://pypi.org/project/ble-mcp-server/)
Canonical MCP server config (stdio transport):
- command: `ble_mcp`
- args: []
- optional environment variables:
- `BLE_MCP_ALLOW_WRITES`: Opt-in env var to allow write operations against BLE characteristics (example: `1`)
Note: Cross-platform Bluetooth Low Energy MCP server using bleak. Read-only by default; writes and plugins are opt-in via env vars.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Cross-platform Bluetooth Low Energy MCP server using bleak. Read-only by default; writes and plugins are opt-in via env vars.
Tools (6)
ble_scan_start
Starts scanning for nearby BLE devices.
ble_connect
Connects to a specified BLE device.
ble_read
Reads characteristic values from a connected BLE device.
ble_write
Writes characteristic values to a connected BLE device.
ble_subscribe
Subscribes to notifications from a connected BLE device.
ble_plugin_load
Loads a specified plugin for high-level device operations.
Environment variables
BLE_MCP_ALLOW_WRITESrequiredSet to 'true' to enable write operations to BLE characteristics.BLE_MCP_AUTH_TOKENrequiredPassword for OAuth approval page on HTTP transports.Packages
ble-mcp-server
pypiv0.3.0transport: stdio
ble-mcp-server
pypiv0.3.0transport: streamable-http
ble-mcp-server
pypiv0.3.0transport: sse
Details
- Language
- Python
- License
- MIT
- Released
- Mar 30, 2026
- Last commit
- Mar 30, 2026
- Registry name
- io.github.es617/ble-mcp-server