LLM Intentions
An open protocol and toolkit for turning Android apps into MCP tool servers, using Android Intents as the native routing layer.
Status: Alpha — Running in production on a real device. 118 tools, 8 sources, one phone.
What is this?
LLM Intentions introduces a new kind of Android app: the CapApp (Capability App). A CapApp has no traditional UI. It exists purely to expose capabilities to LLMs via the Model Context Protocol (MCP). Any developer can build one.
The Hub is the central gateway. It discovers installed CapApps via Android Intents, aggregates their tools into a single MCP endpoint, and namespaces them by source. Connect any MCP client — Claude, Grok, a custom agent — and your phone becomes an AI-native device.
This isn't a spec or a proposal. It's a working system.
Coming next: Intent Mesh — an experimental protocol for routing work between multiple LLMs on the same device. Early scripts and a draft spec are included in this repo.
Architecture
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ Files │ │ Notify │ │ People │ │ Your │
│ CapApp │ │ CapApp │ │ CapApp │ │ CapApp │
└────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘
│ │ │ │
└──────────────┼──────────────┼──────────────┘
│ Android Intents
│
┌──────────────▼──────────────────────┐
│ Hub (port 8379) │
│ MCP Gateway / Tool Aggregator │
│ │
│ ┌───────────┐ ┌────────────────┐ │
│ │ Discovery │ │ Namespace │ │
│ │ Engine │ │ Router │ │
│ └───────────┘ └────────────────┘ │
└──────────────┬──────────────────────┘
│ MCP (streamable-http)
▼
┌───────────────┐
│ MCP Client │
│ Claude / Grok │
│ / Any Agent │
└───────────────┘
Intent Mesh — Multi-LLM Routing (Experimental)
Status: Early experiment. The scripts work but the workflow is manual and rough. Included as a draft spec and proof of concept for where this is heading.
┌──────────────┐ PROCESS_TEXT ┌──────────────┐
│ Claude │ ──── Intent ────> │ Grok │
│ (Taichi TA) │ │ (X Firehose) │
│ │ <── Clipboard ─── │ │
└──────────────┘ or xAI API └──────────────┘
│ │
└────── Intent Mesh ─────────────┘
Synthesized Alpha Signal
The idea: each LLM contributes what it's best at. Claude runs technical analysis via Taichi. Grok reads real-time X/Twitter sentiment. Intent Mesh merges both. Not production-ready yet, but the concept is proven.
What's a CapApp?
A CapApp is an Android APK that:
- Exposes MCP tools via Android Intents — no REST API, no server process needed
- Registers with Hub — Hub discovers it automatically via the AndroidMCP protocol
- Has no UI — it's a headless service that exists to be called by LLMs
- Runs natively — full Android API access (files, contacts, notifications, sensors, etc.)
Think of it like a microservice, but instead of HTTP endpoints, it exposes LLM tools. Instead of a container, it runs as an Android app.
Example CapApps (included)
| CapApp | Package | Tools | What it does |
|---|
| Files | com.llmintentions.files | 15 | File system operations, downloads, media access |
| Notify | com.llmintentions.notify | 7 | Read, filter, dismiss, reply to notifications |
| People | com.llmintentions.people | 10 | Contacts, calendars, events |
Built-in Hub Tools
| Namespace | Tools | What it does |
|---|
android.* | 15 | Intents, app launch, sharing, deep links, maps, d |
... View full README on GitHub
