How do I install Ble?

Ble is a local plugin. Install it using PyPI package: ble-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Ble need?

Ble requires the following credentials or environment variables: BLE_MCP_ALLOW_WRITES, BLE_MCP_WRITE_ALLOWLIST, BLE_MCP_PLUGINS, BLE_MCP_TOOL_SEPARATOR, BLE_MCP_MAX_SESSIONS, BLE_MCP_AUTH_TOKEN. You can find setup instructions on the server detail page.

What AI apps work with Ble?

Ble uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Ble MCP Server

by Enrico Santagati

Developer ToolsLow Risk10.0Local

Free

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

About

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

What You'll Need

Set these up before or after installing:

Enable BLE characteristic writes (off by default for safety)Optional

Environment variable: BLE_MCP_ALLOW_WRITES

Comma-separated UUID allowlist for writable characteristicsOptional

Environment variable: BLE_MCP_WRITE_ALLOWLIST

Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.Optional

Environment variable: BLE_MCP_PLUGINS

Tool name separator character (default '_'). Set to '.' if your client supports dots.Optional

Environment variable: BLE_MCP_TOOL_SEPARATOR

Maximum concurrent MCP sessions (default 1).Optional

Environment variable: BLE_MCP_MAX_SESSIONS

Password for OAuth approval page. Required unless --no-auth is used.Required

Environment variable: BLE_MCP_AUTH_TOKEN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-es617-ble-mcp-server": {
      "env": {
        "BLE_MCP_PLUGINS": "your-ble-mcp-plugins-here",
        "BLE_MCP_ALLOW_WRITES": "your-ble-mcp-allow-writes-here",
        "BLE_MCP_TOOL_SEPARATOR": "your-ble-mcp-tool-separator-here",
        "BLE_MCP_WRITE_ALLOWLIST": "your-ble-mcp-write-allowlist-here"
      },
      "args": [
        "ble-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.