Skip to main content
Glama
claude-antigravity-mcp-bridge

claude-antigravity-mcp-bridge

by im-mahdi-74

Claude Antigravity MCP Bridge

Python Version License

A Model Context Protocol (MCP) bridge enabling Claude Desktop to execute tasks seamlessly via the Google Antigravity CLI (agy).

This bridge exposes the Antigravity CLI to Claude Desktop as a native tool, allowing Claude to harness all capabilities of the Antigravity ecosystem, including its models, skills, plugins, and background workers, completely free from the constraints of a standard chat interface.

Architecture

sequenceDiagram
    participant Claude as Claude Desktop
    participant MCP as claude-antigravity-mcp-bridge
    participant AGY as Antigravity CLI (agy)
    
    Claude->>MCP: Call tool `run_agy_task` with flags
    MCP->>AGY: Spawns subprocess (stdin=DEVNULL)
    AGY-->>MCP: Executes task & returns stdout/stderr
    MCP-->>Claude: Tool result

Related MCP server: agy-headless-bridge MCP server

Setup & Installation

Ensure you have Python 3.9+ installed and the Antigravity CLI available in your system path.

  1. Clone the repository:

    git clone https://github.com/mahdi/claude-antigravity-mcp-bridge.git
    cd claude-antigravity-mcp-bridge
  2. Create a virtual environment:

    python -m venv .venv
    # Windows:
    .\.venv\Scripts\activate
    # macOS/Linux:
    source .venv/bin/activate
  3. Install the package:

    pip install .

Configuration in Claude Desktop

Update your claude_desktop_config.json (accessible via Claude Desktop > Settings > Developer > Edit Config) to point to the bridge:

{
  "mcpServers": {
    "claude-antigravity-bridge": {
      "command": "C:\\path\\to\\claude-antigravity-mcp-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "claude_antigravity_bridge"]
    }
  }
}

Note: Replace C:\\path\\to\\ with the actual absolute path to the cloned repository. Restart Claude Desktop after making this change.

Usage

Once configured, simply instruct Claude Desktop:

"Run the agy bridge and use the default model to print 'Hello'."

Claude will automatically know how to format flags like --print and --model because the tool description embeds a comprehensive Antigravity cheatsheet.

Security Considerations

  • The bridge passes prompts directly to the agy CLI. Be cautious of prompt injection.

  • Interactive terminal prompts from agy are forcefully skipped (--dangerously-skip-permissions) to prevent the MCP process from hanging. Ensure your local agents are configured with appropriate safety boundaries.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Lets MCP clients such as Claude Code, Claude Desktop, Cursor, or Codex hand tasks to the Antigravity CLI (agy) so the work runs on the user's Antigravity plan instead of the client's. Exposes tools for delegated coding tasks and reviews, web search with sources, image/PDF analysis, shell command generation or execution, brainstorming, and model/quota checks.
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude clients to delegate tasks such as web research with sources, reading PDFs, audio, video, images and web pages, image generation, and second opinions to Gemini running under a Google AI Pro subscription via the official Antigravity CLI in headless mode, with no API key or billing.
      6
      MIT