AndroidMCP

An Android app that runs the MCP service directly on your phone, allowing an AI client to access device information, notifications, alarms, private diary, and optional app management.

No computer, Termux, or complex deployment required. Install the APK, grant permissions, and start the service.

AndroidMCP is not a chatbot or cloud Memory service. It gives AI clients real access to your phone while keeping data on the device.

It defaults to loopback-only access. An AI client can connect locally on the phone, or from another device on the same trusted LAN when LAN mode is enabled. Use the app-generated Bearer token for remote access.

Start in three steps

1. Install AndroidMCP and grant the required permissions in the Permissions screen. 2. Choose Local or LAN mode and confirm the port in Settings. 3. Start the service and copy the connection details into your MCP client.

A port or listening-mode change takes effect after restarting the service. Computers, USB, and ADB are optional connection methods, not prerequisites.

Capabilities

- Device: Read battery, storage, network, screen time, and foreground usage by app - Notifications and Alarms: Send instant notifications, create AlarmManager alarms, system clock alarms, and scheduled notifications - Diary: AI can write, read, search, update, and delete private first-person diary entries; phone can add local cover images - App Management: Optional Shizuku channel for listing third-party apps, force-stopping, suspending, and unsuspending apps

There is no Memory database or long-term chat-memory tool. Conversation memory should be maintained by the AI client or Agent.

Tools

tools/list is the authoritative source for the complete live JSON Schema.

- Device: get_device_info, get_screen_time - Notifications: set_alarm, set_clock_alarm, send_notification, schedule_notification - Diary: write_diary, read_diary, search_diary, update_diary, delete_diary - App Management: list_user_apps, force_stop_app, disable_app, enable_app

Valid moods: warm, bright, calm, reflective, heavy. Unsupported values are saved as reflective. created_at is always generated by the phone.

Connection modes

Local mode binds 127.0.0.1:<port>. Use adb forward tcp:8765 tcp:8765 for USB or emulator access, then connect to http://127.0.0.1:8765/mcp.

LAN mode binds 0.0.0.0:<port> and shows real IPv4 endpoints in the app. A remote request requires the exact header Authorization: Bearer <token>. Loopback requests are exempt.

Remote access is limited to 60 requests per IP per minute. Five failed authentications block that IP for five minutes. Request-body limit: 1 MiB.

The server exposes only POST /mcp, implements protocol version 2025-03-26, returns JSON by default, and emits SSE when the request accepts text/event-stream.

Requirements

- Android 8.0 (API 26) or newer - Shizuku (optional, for app management)

Permissions

- get_screen_time requires Usage Access permission - set_clock_alarm requires Overlay permission - Notification and alarm functions are subject to Android system limitations

Interface language:

- Chinese - English

Disclaimer

AndroidMCP is an independent, open-source project. Not affiliated with, endorsed by, or connected to any AI provider. Use at your own risk. Users are responsible for ensuring compliance with applicable laws and terms of service.

License

MIT