iOS BLE-MCP Bridge
Allows interaction with Bluetooth Low Energy (BLE) devices from an iPhone via AI agents, providing tools for scanning, connecting, reading, and writing GATT characteristics.
Enables control of iOS BLE capabilities through a Safari extension (beacio) and WebSocket bridge, allowing AI agents to manage BLE devices on an iPhone.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
iOS BLE-MCP Bridge
Control iPhone Bluetooth Low Energy (BLE) devices from any AI agent (Cursor, Claude Desktop, etc.) via a WebSocket bridge and the beacio Safari extension.
How It Works
AI Agent (PC)
└─ MCP stdio ─► server.js
└─ WebSocket (wss) ─► bridge.js (HTTPS hub, port 3000)
└─ WebSocket ─► iPhone Safari (index.html)
└─ beacio extension ─► BLE Radiobridge.js— HTTPS + WebSocket hub running on your PC (port 3000). Serves the bridge webpage and relays messages between the AI client and your iPhone.server.js— Lightweight MCP server connected to your AI editor via stdio. Forwards tool calls to the bridge hub.public/index.html— The bridge webpage opened on your iPhone. Uses the beacio Safari extension to execute Web Bluetooth commands.
Related MCP server: iPhone MCP
Features
🔵 Scan, connect, read and write BLE devices from your iPhone via AI
🔒 HTTPS with auto-generated self-signed cert (includes IP SAN for LAN access)
🎵 Silent AudioContext background keep-alive (page stays alive when Safari is backgrounded)
🔄 Auto WebSocket reconnect on foreground return
🔔 System Notification support (desktop browsers)
🛡️ Full error handling — no unhandled crashes
Prerequisites
Node.js v18+ on your PC
iPhone with beacio app installed and Safari extension enabled ("Always Allow on Every Website")
PC and iPhone on the same network (Wi-Fi or Tailscale)
Getting Started
1. Install Dependencies
npm install2. Start the Bridge Hub
npm startOn first run, it generates cert.pem / key.pem for HTTPS. The terminal will print all your local IP addresses:
======================================================
[BRIDGE] Hub Server listening on HTTPS port 3000
[BRIDGE] Open this URL in Safari on your iPhone:
👉 https://192.168.1.100:3000
======================================================3. Connect Your iPhone
Open Safari on your iPhone and navigate to the URL shown above.
Safari will warn about the self-signed certificate — tap "visit this website" at the bottom to proceed.
On the bridge webpage, verify:
Bridge Server (WS): Connected (Green)
Safari Extension: Active (beacio) (Green)
Tap Enable on the Background Keep-Alive row to keep the page alive when you switch apps.
Integrate with Your AI Editor
Antigravity / Cursor
Add to your MCP config (adjust the path to wherever you cloned this repo):
{
"mcpServers": {
"ble-bridge": {
"command": "node",
"args": ["/path/to/ble-mcp-bridge/server.js"]
}
}
}Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"ble-bridge": {
"command": "node",
"args": ["/path/to/ble-mcp-bridge/server.js"]
}
}
}Available MCP Tools
Tool | Description |
| Check if iPhone bridge is connected |
| Scan for nearby BLE devices (triggers user approval on iPhone) |
| Connect to a paired device by ID |
| Read a GATT characteristic value (returns hex) |
| Write a hex value to a GATT characteristic |
Example Prompts
Check if my iPhone bridge is connected.Scan for nearby Bluetooth devices with the heart_rate service.Connect to device <id> with services ['heart_rate'].Read the battery level (service '180f', characteristic '2a19') from my connected device.Notes
AirPods / Apple devices: Cannot be connected via Web Bluetooth (iOS system restriction).
Classic Bluetooth: Not supported. Only BLE (Low Energy) devices work.
Scan requires user gesture: When scanning for a new device, you must tap the Approve button on the iPhone. Once connected, all read/write operations run silently in the background.
Self-signed cert: Delete
cert.pem/key.pemand restartbridge.jsto regenerate with updated IP SANs if your network changes.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
iMessage for AI agents, from your iPhone. No Mac needed, and you choose which chats they read.
Let your AI agent control real iPhones: screenshots, tap, swipe, type and open apps.
Connect AI agents to your own Chrome with scoped access, approvals, and verified task results.
Build, run, debug, test and ship Chrome, Firefox, Edge and Safari extensions from your AI agent.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides AI assistants with Safari browser automation and developer tools access, enabling LLMs to control Safari, access console logs, monitor network activity, and perform browser automation tasks.139 npm33MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control real iPhones and simulators on macOS, allowing for UI interaction, testing, and automation.90 npm98MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to control Bluetooth Low Energy devices remotely through a WebSocket and Web Bluetooth bridge, exposing tools for vibration, suction, licking, pulsing, and status checks.MIT
- AlicenseBqualityBmaintenanceEnables AI agents to drive the user's already-running Google Chrome through a WebSocket bridge, listing and switching tabs, navigating, clicking, typing, scrolling, extracting DOM, taking screenshots, and evaluating JavaScript. It works without restarting Chrome and preserves all existing logins, cookies, and 2FA sessions.253 npmMIT