Skip to content
Gemini CLI

ble mcp server for Gemini CLI

io.github.es617/ble-mcp-server

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

client:Gemini CLI transport:stdio runtime:pypi

Install ble mcp server in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "ble-mcp-server": {
      "command": "uvx",
      "args": [
        "ble-mcp-server"
      ],
      "env": {
        "BLE_MCP_ALLOW_WRITES": "<BLE_MCP_ALLOW_WRITES>",
        "BLE_MCP_WRITE_ALLOWLIST": "<BLE_MCP_WRITE_ALLOWLIST>",
        "BLE_MCP_PLUGINS": "<BLE_MCP_PLUGINS>",
        "BLE_MCP_TOOL_SEPARATOR": "<BLE_MCP_TOOL_SEPARATOR>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

ble mcp server in other clients