Bluetooth MCP Server

@Hypijump31

About Bluetooth MCP Server

bluetooth-mcp-server for Claude AI

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bluetooth-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Bluetooth MCP Server?

Bluetooth MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude to scan and interact with Bluetooth devices in your vicinity. It provides a robust, cross-platform interface for detecting both BLE and Classic Bluetooth devices.

How to use Bluetooth MCP Server?

Install the server by cloning the repository, setting up a virtual environment, installing dependencies, and configuring environment variables. Start the Bluetooth API server with python run.py and the MCP server with python bluetooth_mcp_server.py. For use with Claude, expose the server via ngrok and configure Claude using the MCP SDK.

Key features of Bluetooth MCP Server

Multi‑protocol scanning (BLE and Classic)
Flexible filtering by name, type, or attributes
Automatic device recognition and categorization
Enhanced device information (manufacturer, type, characteristics)
Cross‑platform support (Windows, macOS, Linux)
MCP integration with Claude and AI assistants

Use cases of Bluetooth MCP Server

AI assistant scanning for nearby Bluetooth devices to provide context‑aware responses
Inventory management by detecting and categorizing Bluetooth devices in an area
Troubleshooting connectivity by identifying device types and characteristics

FAQ from Bluetooth MCP Server

What system requirements does Bluetooth MCP Server need?

Python 3.7+, a Bluetooth adapter (built‑in or external), admin/sudo privileges, and an internet connection for package installation.

How do I fix “Access denied” errors when running the server?

Run the server with admin/sudo privileges, as some Bluetooth operations require elevated rights.

Why is no Bluetooth adapter detected?

Ensure Bluetooth is enabled in your system settings and the adapter is properly installed.

What if no Bluetooth devices are found during a scan?

Make sure there are discoverable Bluetooth devices nearby and that they are in range.

How does Bluetooth MCP Server integrate with Claude?

Expose the server URL via ngrok (or deploy it) and install the Model Context Protocol using npx @anthropic-ai/sdk install-model-context-protocol <YOUR_SERVER_URL>.

Frequently asked questions