Bluetooth Low Energy
Bluetooth Low Energy (BLE) MCP server for Claude Code and other MCP-compatible agents.
What is Bluetooth Low Energy?
Bluetooth Low Energy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to bluetooth low energy (ble) mcp server for claude code and other mcp-compatible agents.
Bluetooth Low Energy (BLE) MCP server for Claude Code and other MCP-compatible agents.
This server falls under the Developer Tools and Monitoring & Observability categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Bluetooth Low Energy (BLE) MCP server for Claude Code and ot
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bleConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bluetooth Low Energy
BLE MCP Server exposes Bluetooth Low Energy device scanning, connection, and data exchange to AI agents through the Model Context Protocol. It supports reading and writing GATT characteristics, subscribing to notifications, registering protocol specs, and loading plugins — giving Claude Code and other MCP clients full programmatic access to nearby BLE hardware.
Prerequisites
- Python 3.9 or higher with pip or uv available
- A system with a working Bluetooth adapter (macOS, Linux, or Windows with appropriate drivers)
- Bluetooth permissions granted to the terminal / application running the server
- An MCP-compatible client such as Claude Code or Cursor
Install the package
Install ble-mcp-server from PyPI using pip or uv. The package provides the ble_mcp command-line entry point.
pip install ble-mcp-server
# Or with uv:
uv pip install ble-mcp-serverAdd the server to Claude Code (read-only mode)
Register the BLE server with Claude Code using the minimal configuration. This gives read-only access — scanning and reading characteristics, but no writes.
claude mcp add ble -- ble_mcpEnable write access (optional)
If you need to write to BLE characteristics, enable writes globally or restrict them to a specific UUID allowlist for safety.
# Enable writes globally:
claude mcp add ble -e BLE_MCP_ALLOW_WRITES=true -- ble_mcp
# Or restrict to specific characteristic UUIDs:
claude mcp add ble \
-e BLE_MCP_ALLOW_WRITES=true \
-e BLE_MCP_WRITE_ALLOWLIST="2a00,12345678-1234-1234-1234-123456789abc" \
-- ble_mcpEnable device plugins (optional)
Plugins add higher-level support for specific device types such as SensorTag. Load all available plugins or specify individual ones by name.
claude mcp add ble -e BLE_MCP_PLUGINS=all -- ble_mcp
# Or specific plugins:
claude mcp add ble -e BLE_MCP_PLUGINS=sensortag,hello -- ble_mcpVerify with MCP Inspector
Use the MCP Inspector to interactively test the server and confirm BLE tools are available before connecting your AI client.
npx @modelcontextprotocol/inspector ble_mcpBluetooth Low Energy Examples
Client configuration
VS Code mcp.json configuration for the BLE MCP Server with write access and all plugins enabled.
{
"servers": {
"ble": {
"type": "stdio",
"command": "ble_mcp",
"args": [],
"env": {
"BLE_MCP_ALLOW_WRITES": "true",
"BLE_MCP_PLUGINS": "all",
"BLE_MCP_LOG_LEVEL": "INFO"
}
}
}
}Cursor / claude_desktop_config.json
Configuration for Cursor or Claude Desktop using the ble_mcp command.
{
"mcpServers": {
"ble": {
"command": "ble_mcp",
"args": [],
"env": {
"BLE_MCP_ALLOW_WRITES": "true",
"BLE_MCP_PLUGINS": "all"
}
}
}
}Prompts to try
Example natural-language prompts to use once BLE MCP Server is connected.
- "Scan for nearby BLE devices for 10 seconds and list everything you find with signal strength."
- "Connect to the device named 'Arduino' and discover all its services and characteristics."
- "Read the Battery Level characteristic (UUID 2a19) from the connected device."
- "Subscribe to notifications on characteristic 2a37 and report each value you receive."Troubleshooting Bluetooth Low Energy
Scan starts but returns no devices
Ensure Bluetooth is enabled on your system and that the terminal or application has been granted Bluetooth permissions (on macOS: System Settings → Privacy & Security → Bluetooth). Try increasing scan duration in your prompt.
Write operations fail with 'writes not permitted' error
The server defaults to read-only mode. Re-register with BLE_MCP_ALLOW_WRITES=true, or if you want to restrict to safe characteristics only, also set BLE_MCP_WRITE_ALLOWLIST to a comma-separated list of characteristic UUIDs.
ble_mcp command not found after installation
Ensure the Python scripts directory is in your PATH. On macOS/Linux run 'which ble_mcp' after installation. If using a virtual environment, activate it first. With uv, run 'uv run ble_mcp' instead.
Frequently Asked Questions about Bluetooth Low Energy
What is Bluetooth Low Energy?
Bluetooth Low Energy is a Model Context Protocol (MCP) server that bluetooth low energy (ble) mcp server for claude code and other mcp-compatible agents. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bluetooth Low Energy?
Follow the installation instructions on the Bluetooth Low Energy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bluetooth Low Energy?
Bluetooth Low Energy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bluetooth Low Energy free to use?
Yes, Bluetooth Low Energy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Bluetooth Low Energy Alternatives — Similar Developer Tools Servers
Looking for alternatives to Bluetooth Low Energy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bluetooth Low Energy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bluetooth Low Energy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.