aster-mcp
v0.1.14
Published
MCP server for Android - Your AI CoPilot on Mobile or give your AI its own phone
Maintainers
Readme
Aster is an MCP server that bridges any Android device to AI assistants. Use it as your AI CoPilot on mobile — or give your AI a dedicated device and let it call you, text you, and act autonomously. Screenshots, UI automation, file management, notifications, media search, and 40+ tools — all through natural language. Fully open source and privacy-first.
Built for OpenClaw — works natively as a skill on OpenClaw, Moltbot, and Clawbot. Also supports Claude and any MCP-compatible client.
Web Dashboard
Installation
npm install -g aster-mcpQuick Start
# 1. Start the server
aster start
# 2. Install the Aster app on any Android device
# — your daily phone or a spare one for your AI
# Connect using the address shown in terminal
# 3. Connect your AI assistant (see below)Connect Your AI Assistant
OpenClaw / Moltbot / Clawbot (Recommended)
Aster is a first-class skill on ClawHub. One command to install:
clawhub install asterThat's it. Your AI assistant is now your CoPilot on mobile — or it can use a dedicated phone as its own. See the skill configuration for advanced setup.
Claude Code / Claude Desktop
Add to your .mcp.json or Claude settings:
{
"mcpServers": {
"aster": {
"type": "http",
"url": "http://localhost:5988/mcp"
}
}
}Any MCP-Compatible Client
Aster exposes a standard MCP HTTP endpoint at http://localhost:5988/mcp.
What Can It Do?
Your CoPilot on Mobile — talk to your AI assistant naturally:
"Take a screenshot of my phone"
"Open YouTube and search for cooking videos"
"Read my latest notifications"
"Find photos from my trip to Mumbai last month"
"What apps are using the most storage?"
Give your AI its own phone — plug in a spare Android and let it act:
"Call me if my flight gets delayed or the gate changes"
"Monitor delivery notifications and text me when the package arrives"
"Back up all new photos to Google Drive every night"
Commands
aster start # Start the server (with optional event forwarding setup)
aster stop # Stop the server
aster status # Show server and device status
aster dashboard # Open web dashboard
aster devices list # List connected devices
aster devices approve # Approve a pending device
aster devices reject # Reject a device
aster devices remove # Remove a device
aster set-openclaw-callbacks # Configure proactive event forwardingProactive Event Forwarding
Aster can push real-time events from the phone to your AI agent via webhook — your AI reacts the moment something happens, no polling needed.
- Incoming SMS — auto-reply while driving, forward OTPs, escalate urgent messages
- App notifications — flight delays, delivery updates, ride arrivals — your AI knows instantly
- Device events — device online/offline, new device pairing requests
Works out of the box with OpenClaw, ClawdBot, and MoltBot. Configure via the dashboard at /settings/openclaw or CLI:
aster set-openclaw-callbacksAvailable MCP Tools
| Category | Tools |
|----------|-------|
| Screen | take_screenshot, get_screen_hierarchy, find_element |
| Input | input_gesture, input_text, click_by_text, click_by_id |
| Navigation | global_action, launch_intent |
| Device | list_devices, get_device_info, get_battery, get_location |
| Notifications | read_notifications, read_sms, send_sms, post_notification |
| Files | list_files, read_file, write_file, delete_file |
| Storage | analyze_storage, find_large_files, search_media |
| Clipboard | get_clipboard, set_clipboard |
| Calls | make_call, make_call_with_voice |
| Audio | speak_tts, play_audio, vibrate |
| Apps | list_packages, execute_shell (sandboxed, no root) |
Security & Privacy
Aster is built with a security-first, privacy-first architecture:
- Self-Hosted — Runs entirely on your local machine. No cloud servers, no third-party relays.
- Zero Telemetry — No analytics, no tracking, no usage data collection.
- Device Approval — Every new device must be manually approved from the dashboard before it can connect.
- Tailscale Integration — Optional encrypted mesh VPN with WireGuard. Secure remote access with automatic TLS, no port forwarding.
- No Root Required — Uses the official Android Accessibility Service API. No rooting, no ADB hacks. Every action is permission-gated and sandboxed.
- Local Storage Only — All data stored in a local SQLite database. Nothing is sent externally.
- 100% Open Source — MIT licensed, fully auditable codebase.
Requirements
- Node.js >= 20
- Any Android device with Aster app installed (your phone or a dedicated AI device)
- Device and server on same network (or Tailscale for secure remote access)
License
MIT
