Skip to main content

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

Project description

PyPI Licence

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

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:

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simpleaible-0.12.1.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simpleaible-0.12.1-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file simpleaible-0.12.1.tar.gz.

File metadata

  • Download URL: simpleaible-0.12.1.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for simpleaible-0.12.1.tar.gz
Algorithm Hash digest
SHA256 2ef8bd78cdfc64146815bf6609df1590f6709b07352db8c607762c2839788357
MD5 dd8358a02a94085772ad2a2b4d6a8df9
BLAKE2b-256 a0b928d2960b47ec18521ec57f037db1853ddc1ea2b6ab595bbcf942383e8fdc

See more details on using hashes here.

File details

Details for the file simpleaible-0.12.1-py3-none-any.whl.

File metadata

  • Download URL: simpleaible-0.12.1-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for simpleaible-0.12.1-py3-none-any.whl
Algorithm Hash digest
SHA256 595781fefad34d7d5bf565e48d91282488a823f27d88bd79e8983a6a62bec47e
MD5 47b08af3db8b3a34c0bc77cc81f03391
BLAKE2b-256 005a6567520e0f9d6a7397048d549a6a0ab2128340d24654e94822524a64f797

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page