simpleaible 1.0.1.dev2

SimpleAIBLE is an AI-friendly BLE toolkit (MCP server & REST API) powered by SimplePyBLE.

SimpleAIBLE

An AI-friendly BLE toolkit powered by SimpleBLE. Scan, connect, and interact with Bluetooth Low Energy devices from AI agents and scripts.

Key Features

• MCP Server: Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, Windsurf, etc.)

• HTTP Server: Control BLE devices over a REST API

• Agent Skills: Teach your AI assistant how to work with Bluetooth devices using reusable skill files

• Cross-Platform: Works on Windows, macOS, and Linux

Support & Resources

We’re here to help you succeed with SimpleAIBLE:

• Documentation: Visit our docs page for comprehensive guides

• Commercial Support: Check out our website or email us about licensing and professional services.

• Community: Join our Discord server for discussions and help

• Dongl: Pair AI-driven BLE workflows with the official SimpleBLE Bluetooth dongle.

Don’t hesitate to reach out if you need assistance - we’re happy to help!

Installation

Install SimpleAIBLE using your preferred package manager:

Using uv (recommended):

uv tool install simpleaible

Or using pip:

pip install simpleaible

MCP Server

Expose BLE operations as tools for MCP-capable clients (Cursor, Claude Code, etc.). Configure it in your MCP client with the following command: "command": "simpleaible-mcp".

See the MCP Server docs for full tool documentation and client-specific setup.

HTTP Server

Run the REST API for controlling BLE devices remotely:

simpleaible-http --host 127.0.0.1 --port 8000

See the HTTP Server docs for the full API reference.

Agent Skills

Install the SimpleAIBLE skill to give your AI agent built-in knowledge of BLE workflows. The bundled installer detects Claude Code and Codex automatically:

simpleaible install

Run simpleaible uninstall to remove the skill again. For other agents, use the skills CLI:

npx skills add https://github.com/simpleble/simpleble --skill simpleaible

See the Agent Skills docs for more details.

License

SimpleAIBLE is available under the Business Source License 1.1 (BUSL-1.1). Each version of SimpleAIBLE will convert to the GNU General Public License version 3 after four years of its initial release. Qualifying non-commercial users may instead continue using and distributing that version under the original BUSL-1.1 terms under the Non-Commercial Perpetual Use Grant in LICENSE.md.

The project is free to use for non-commercial purposes, but requires a commercial license for commercial use. We also offer FREE commercial licenses for small projects and early-stage companies - reach out to discuss your use case!

Why purchase a commercial license?

• Build and deploy unlimited commercial applications

• Use across your entire development team

• Zero revenue sharing or royalty payments

• Choose features that match your needs and budget

• Priority technical support included

• Clear terms for integrating into MIT-licensed projects

Looking for information on pricing and commercial terms of service? Visit www.simpleble.org for more details.

For further enquiries, please email us or leave us a message on our website and we can discuss the specifics of your situation.

---

SimpleAIBLE is a project powered by The California Open Source Company.