Your AI CoPilot on Mobile — or give your AI its own phone
Website • Installation • Connect AI • Features • Tools • Security
Dashboard Overview • Device Telemetry • File Browser & Preview • MCP Tool Explorer
## Installation ```bash npm install -g aster-mcp ``` ## Quick Start ```bash # 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](https://clawhub.ai/satyajit/aster). One command to install: ```bash clawhub install aster ``` That'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](https://github.com/satyajiit/aster-mcp/tree/main/skill) for advanced setup. ### Claude Code / Claude Desktop Add to your `.mcp.json` or Claude settings: ```json { "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 ```bash 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 forwarding ``` ## Proactive 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: ```bash aster set-openclaw-callbacks ``` ## Available 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](https://tailscale.com) for secure remote access) ## License MIT ---