English Français العربية

iOS Web Bluetooth (WebBLE)

Official registry Other

MCP server to ship Web Bluetooth on iPhone Safari via the WebBLE extension.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @ios-web-bluetooth/mcp
Claude Code 
claude mcp add ios-web-bluetooth-webble -- npx -y @ios-web-bluetooth/mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ios-web-bluetooth-webble": {
            "command": "npx",
            "args": [
                "-y",
                "@ios-web-bluetooth/mcp@0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

beacio SDK

Web Bluetooth SDK for iOS Safari. Scan, connect, and talk to BLE devices from any web app.

Packages

PackagePurposeSize
@beacio/coreBLE scanning, connecting, GATT read/write/subscribe~4KB gzip
@beacio/core/detectiOS extension detection + install banner~2KB gzip
@beacio/core/profilesTyped BLE profiles (heart rate, battery, etc.)Optional
@beacio/reactReact hooks (useDevice, useCharacteristic)Optional
@beacio/mcpMCP server for AI coding agents + the beacio scaffolding CLI (npx beacio init)Optional

Quick Start

npm install @beacio/core
import { initBeacio, isIOSSafari } from '@beacio/core/detect';
import { beacio, BeacioError } from '@beacio/core';

// 1. On iOS Safari, detect the extension and prompt install if missing
if (isIOSSafari()) {
  await initBeacio({
    operatorName: 'MyApp',
    banner: { mode: 'sheet' },
    onReady: () => console.log('Extension ready'),
  });
}

// 2. Scan and connect (works on iOS Safari + Chrome + Edge)
const ble = new beacio();
const device = await ble.requestDevice({
  filters: [{ services: ['heart_rate'] }],
});

await device.connect();

// 3. Read a value
const value = await device.read('heart_rate', 'heart_rate_measurement');
console.log('Heart rate:', value.getUint8(1));

// 4. Subscribe to notifications
const unsub = device.subscribe('heart_rate', 'heart_rate_measurement', (v) => {
  console.log('Heart rate:', v.getUint8(1));
});

// 5. Clean up
unsub();
await device.disconnect();

For plain HTML (no bundler):

<script src="https://beacio.com/beacio.js"></script>

Frequently asked questions

What is iOS Web Bluetooth (WebBLE)?

MCP server to ship Web Bluetooth on iPhone Safari via the WebBLE extension.

How do I install iOS Web Bluetooth (WebBLE)?

It runs on your machine. In Claude Code: claude mcp add ios-web-bluetooth-webble -- npx -y @ios-web-bluetooth/mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does iOS Web Bluetooth (WebBLE) need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is iOS Web Bluetooth (WebBLE) open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains iOS Web Bluetooth (WebBLE)?

It is published by wklm. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.