Antigravity Mobile Command MCP Server
Allows sending coding tasks from a mobile device via Telegram, with interactive approval of plans and code changes, real-time progress updates, error notifications, and visual verification through screenshots and recordings.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Antigravity Mobile Command MCP Server send a new coding task to build a login page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
š Antigravity Mobile Command
Transform your mobile device into a remote Mission Control for your coding environment.
Antigravity Mobile Command is an "Agentic Bridge" that leverages Google Antigravity's native Model Context Protocol (MCP) and Artifact system to provide a bi-directional, real-time feedback loop via Telegram.

⨠Features
š± Prompt-to-Action Loop: Send coding tasks from your phone, approve plans with inline buttons
šø Visual Verification: Auto-receive screenshots and recordings of UI changes
ā Interactive Governance: Approve or reject code diffs via Telegram buttons
šØ Error Awareness: Get notified of terminal crashes with full stack traces
š Live Status Ticker: Real-time progress updates without message spam
Related MCP server: mcp-telegram-claudecode
š ļø Quick Start
Prerequisites
Python 3.10+
A Telegram Bot Token (from @BotFather)
Your Telegram Chat ID (from @userinfobot)
Installation
# Clone the repository
git clone https://github.com/yourusername/antigravity-telegram.git
cd antigravity-telegram
# Install dependencies
pip install -e .
# Or with uv
uv pip install -e .Configuration
Copy the example environment file:
cp .env.example .envEdit
.envwith your credentials:
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
AUTHORIZED_CHAT_IDS=your_chat_id
ARTIFACTS_PATH=~/.gemini/antigravity/artifactsRunning
Run both Telegram bot and MCP server:
python -m src.mainRun only the Telegram bot:
python -m src.main --mode botRun only the MCP server (for Antigravity integration):
python -m src.main --mode mcpš Antigravity MCP Integration
1. Add to MCP Config
Add the Telegram bridge to your Antigravity MCP configuration (~/.gemini/mcp_config.json):
{
"mcpServers": {
"telegram-bridge": {
"command": "python",
"args": ["-m", "src.main", "--mode", "mcp"],
"cwd": "/path/to/antigravity-telegram",
"env": {
"TELEGRAM_BOT_TOKEN": "your_token",
"AUTHORIZED_CHAT_IDS": "your_chat_id",
"ARTIFACTS_PATH": "~/.gemini/antigravity/artifacts"
}
}
}
}2. Copy the Workflow
Copy the workflow file to your Antigravity workflows:
cp workflows/mobile-command.md ~/.agent/workflows/3. Use from Telegram
Start a chat with your bot on Telegram
Send
/startto verify the connectionSend
/prompt "Your coding task here"Approve plans and review changes from your phone!
š± Telegram Commands
Command | Description |
| Show welcome message and verify connection |
| Send a coding task to Antigravity |
| Check current execution status |
| Cancel the current operation |
| Show help message |
š§ MCP Tools Available
The following tools are exposed to Antigravity for communication:
Tool | Description |
| Send messages to the user |
| Request approval for implementation plans |
| Request approval for code changes |
| Send screenshots/recordings to Telegram |
| Update the status ticker message |
| Send critical error notifications |
| Wait for user input |
šļø Architecture
āāāāāāāāāāāāāāāāāāā āāāāāāāāāāāāāāāāāāāā āāāāāāāāāāāāāāāāāāā
ā š± Telegram āāāāāāŗā š Python āāāāāāŗā š Antigravity ā
ā App ā ā Bridge ā ā Agent ā
āāāāāāāāāāāāāāāāāāā āāāāāāāāāāāāāāāāāāāā āāāāāāāāāāāāāāāāāāā
ā
ā¼
āāāāāāāāāāāāāāāāāāāā
ā š Artifact ā
ā Watcher ā
āāāāāāāāāāāāāāāāāāāāš Project Structure
antigravity-telegram/
āāā src/
ā āāā main.py # Entry point
ā āāā config.py # Configuration management
ā āāā bot/
ā ā āāā handlers.py # Telegram command handlers
ā ā āāā keyboards.py # Inline keyboard builders
ā ā āāā message_queue.py # Async message queue
ā āāā mcp_server/
ā ā āāā server.py # MCP server implementation
ā ā āāā tools.py # MCP tool definitions
ā ā āāā state.py # Approval state management
ā āāā monitors/
ā ā āāā artifacts.py # Artifact directory watcher
ā ā āāā terminal.py # Terminal output monitor
ā āāā utils/
ā āāā formatting.py # Message formatting
āāā config/
ā āāā mcp_config.json # MCP config template
āāā workflows/
ā āāā mobile-command.md # Antigravity workflow
āāā .env.example
āāā pyproject.toml
āāā README.mdš Security
Only authorized chat IDs can interact with the bot
Bot tokens are stored in environment variables
Session files are gitignored
š License
MIT License - see LICENSE for details.
š¤ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Built with ā¤ļø for the Antigravity community
Available Tools
17 toolsawait_user_responseA
Wait for the user to respond with a message. Use when you need specific input or instructions from the user.
Inputs: prompt (required), timeout_seconds.
get_pending_promptsA
Check for pending prompts from the Telegram user. Call this when the user asks you to check telegram or at the start of a session. Returns any queued prompts that the user sent via the Telegram bot.
Inputs: clear_after_read.
get_project_contextA
Get information about the current project context. Returns project path, file counts by type, git status, and settings.
Inputs: no named parameters.
list_project_filesA
List files and directories in the project. Use to explore project structure or find files matching a pattern.
Inputs: pattern, directory, recursive.
notify_errorA
Send a critical error notification to the user. Use when terminal commands fail or errors occur that need user attention.
Inputs: error_message (required), command, stack_trace.
read_project_fileA
Read the contents of a file from the current project. Use to report file contents back to Telegram or verify changes.
Inputs: file_path (required), end_line, start_line.
request_change_approvalA
Request approval for specific code changes. Use for reviewing important modifications before they are committed.
Inputs: change_summary (required), diff_preview.
request_plan_approvalA
Request approval for an implementation plan before making changes. Use this before modifying more than 3 files or making significant changes. The user will see the plan summary and can approve or reject.
Inputs: plan_summary (required), task_name, files_affected.
run_terminal_commandA
Run a terminal command in the project directory. Returns stdout, stderr, and return code. Use for builds, tests, etc.
Inputs: command (required), timeout.
search_project_codeA
Search for code patterns in the project using grep. Returns matching files with line numbers and content snippets.
Inputs: query (required), file_types, max_results.
send_artifactA
Send an artifact (screenshot, recording, or file) to the user via Telegram. Use after capturing UI screenshots or generating visual content.
Inputs: artifact_path (required), caption.
send_code_updateA
Send a code update notification to Telegram. Use after making significant code changes to inform the user.
Inputs: summary (required), file_path (required), change_type (required), diff_preview.
send_telegram_messageA
Send a message to the user via Telegram. Use for status updates, informational messages, or any communication that doesn't require approval.
Inputs: message (required), priority.
set_project_contextA
Set the current project path for IDE operations. All file operations will be relative to this path.
Inputs: project_path (required).
update_statusA
Update the status ticker message. This edits the existing status message instead of sending a new one, reducing message spam.
Inputs: status_text (required), progress_percent.
wait_for_new_promptA
Wait efficiently for a new prompt to arrive from Telegram. Blocks until a prompt is found or timeout is reached. Use this in a loop to monitor for incoming tasks.
Inputs: timeout_seconds.
write_project_fileA
Write content to a file in the project. Creates parent directories if needed. Use for code modifications.
Inputs: content (required), file_path (required), create_dirs.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 17 tools
Tools are largely distinct, with clear semantic purposes for each communication or file operation. Some overlap exists between messaging tools (send_telegram_message vs send_code_update) and between prompt-waiting tools (await_user_response vs wait_for_new_prompt), but descriptions clarify intended use cases.
All tool names follow a consistent verb_noun pattern in lower_snake_case, making the API predictable and easy to navigate.
At 17 tools, the set is slightly large, but each tool addresses a distinct need in the mobile command workflow, covering both communication and project operations. It feels heavy but not bloated.
The toolset covers the core lifecycle of receiving prompts, exploring modules, editing files, running commands, and sending updates/approvals. Minor gaps exist (e.g., no dedicated delete file) but can be worked around via terminal commands.
Maintenance
Related MCP Connectors
Project memory, tasks and Telegram notifications for your coding agent. Chip account required.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Build and deploy websites, Telegram and Discord bots from chat via the DreamAgent platform.
Let AI assistants post to your Telegram chats, groups and channels. Not affiliated with Telegram.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables remote control of AI coding assistants (Claude Code/Codex) via Telegram, allowing you to manage long-running tasks, send commands, and receive notifications from anywhere. Supports unattended mode with smart polling for up to 7 days and multi-session management.825 PyPI30MIT
- AlicenseAqualityDmaintenanceEnables Claude Code to send and receive messages via Telegram for remote interaction and approval of sensitive operations.8189 npm7MIT
- AlicenseNot gradedqualityBmaintenanceEnables remote control of Claude Code through Telegram, letting users start or resume sessions, review tool calls with approve/deny buttons, and manage long-running work from a phone.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to operate a Telegram account through the same commands as the terminal client: messaging, chat management, voice transcription, calls, stickers, and privacy settings.1MIT