{"id":48236010,"url":"https://github.com/beeper/mcp-android","last_synced_at":"2026-05-30T08:30:26.857Z","repository":{"id":352557380,"uuid":"1038338028","full_name":"beeper/mcp-android","owner":"beeper","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-16T14:40:42.000Z","size":88,"stargazers_count":8,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T07:02:46.531Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beeper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-15T02:41:40.000Z","updated_at":"2026-01-28T04:32:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/beeper/mcp-android","commit_stats":null,"previous_names":["beeper/mcp-android"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/beeper/mcp-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeper%2Fmcp-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeper%2Fmcp-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeper%2Fmcp-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeper%2Fmcp-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beeper","download_url":"https://codeload.github.com/beeper/mcp-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beeper%2Fmcp-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33686018,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T20:00:26.649Z","updated_at":"2026-05-30T08:30:26.849Z","avatar_url":"https://github.com/beeper.png","language":"Kotlin","funding_links":[],"categories":["🤖 MCP Servers"],"sub_categories":[],"readme":"# Beeper MCP Server\n\nAn Android MCP (Model Context Protocol) server that provides access to Beeper chat data for AI assistants. This server exposes Beeper's chats, contacts, and messaging capabilities through an MCP interface.\n\n## Prerequisites\n\n- **Android device** with Beeper Android app installed\n- **Same device requirement**: This MCP server must be installed on the same Android device as Beeper\n- Android 8.0 (API level 26) or higher\n- Android Studio or build tools for compilation\n\n## Build and Installation\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/your-repo/beeper-mcp.git\ncd beeper-mcp\n```\n\n### 2. Connect Your Device\n1. Connect your Android device via USB\n2. Enable **Developer Options** and **USB Debugging**\n\n### 3. Build and Install\n\n#### Option A: Command Line\n```bash\n./gradlew installDebug\n```\n\n#### Option B: Android Studio\n1. Open the project in Android Studio\n2. Sync project with Gradle files\n3. Run the app: **Run → Run 'app'**\n\n## Setup and Usage\n\n### 1. Grant Permissions\nAfter installation, open the Beeper MCP Server app and:\n- Grant **Beeper permissions** (read/send access)\n- **Disable battery optimization** for the app (recommended)\n- The service will start automatically once permissions are granted\n\n### 2. Connect to Claude\nOnce the server is running, add it to Claude Code:\n\n```bash\nclaude mcp add --transport sse beeper-android http://[DEVICE_IP]:8081\n```\n\nReplace `[DEVICE_IP]` with your Android device's IP address (shown in the app).\n\n## Available MCP Tools\n\n- **get_chats** - Retrieve chats with filtering options\n- **get_contacts** - Retrieve contacts with filtering options  \n- **get_messages** - Retrieve messages with search capabilities\n- **send_message** - Send messages to specific chats\n\n## Important Notes\n\n- **Device Requirement**: The MCP server must run on the same Android device as Beeper to access the content provider\n- **Network Access**: Ensure your device and Claude Code client are on the same network\n- **Permissions**: Beeper permissions are required for the server to function\n- **Battery**: Consider disabling battery optimization to prevent the service from being killed\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeeper%2Fmcp-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeeper%2Fmcp-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeeper%2Fmcp-android/lists"}