Skip to content
mcp/skillhub

Ble MCP Server

by es617io.github.es617/ble-mcp-serverv0.3.0

Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.

18Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale6mo ago

Install Ble MCP server

Install in Claude Code

claude mcp add ble -- uvx ble-mcp-server

Configuration

VariableRequiredSecretDescription
BLE_MCP_ALLOW_WRITES——Enable BLE characteristic writes (off by default for safety)
BLE_MCP_WRITE_ALLOWLIST——Comma-separated UUID allowlist for writable characteristics
BLE_MCP_PLUGINS——Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.
BLE_MCP_TOOL_SEPARATOR——Tool name separator character (default '_'). Set to '.' if your client supports dots.
BLE_MCP_MAX_SESSIONS——Maximum concurrent MCP sessions (default 1).
BLE_MCP_AUTH_TOKENyesyesPassword for OAuth approval page. Required unless --no-auth is used.

Freshness

Stale — last maintenance signal 6mo ago. The newest of the signals below sets the band.

  1. Last commit (default branch)

    2026-03-30 · 6mo ago · GitHub

  2. Latest release

    2026-03-30 · 6mo ago · GitHub · v0.3.0

  3. Package published

    no data · npm/PyPI

  4. Registry entry updated

    2026-03-30 · 6mo ago · official registry · v0.3.0

FAQ

›How do I install the Ble MCP server in Claude Code?

Run: claude mcp add ble -- uvx ble-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ble require an API key?

Yes. It expects BLE_MCP_AUTH_TOKEN, of which 1 is a secret.

›Can I use Ble as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Ble in the official MCP registry?

Yes, as io.github.es617/ble-mcp-server.