Skip to main content
Glama
JacksonFuck

Antigravity Mobile Command MCP Server

by JacksonFuck

🚀 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.

Telegram Bot Preview

✨ 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: Codex MCP Telegram

🛠️ Quick Start

Prerequisites

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

  1. Copy the example environment file:

cp .env.example .env
  1. Edit .env with your credentials:

TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
AUTHORIZED_CHAT_IDS=your_chat_id
ARTIFACTS_PATH=~/.gemini/antigravity/artifacts

Running

Run both Telegram bot and MCP server:

python -m src.main

Run only the Telegram bot:

python -m src.main --mode bot

Run 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

  1. Start a chat with your bot on Telegram

  2. Send /start to verify the connection

  3. Send /prompt "Your coding task here"

  4. Approve plans and review changes from your phone!

📱 Telegram Commands

Command

Description

/start

Show welcome message and verify connection

/prompt <text>

Send a coding task to Antigravity

/status

Check current execution status

/cancel

Cancel the current operation

/help

Show help message

🔧 MCP Tools Available

The following tools are exposed to Antigravity for communication:

Tool

Description

send_telegram_message

Send messages to the user

request_plan_approval

Request approval for implementation plans

request_change_approval

Request approval for code changes

send_artifact

Send screenshots/recordings to Telegram

update_status

Update the status ticker message

notify_error

Send critical error notifications

await_user_response

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JacksonFuck/antigravity-telegram'

If you have feedback or need assistance with the MCP directory API, please join our Discord server