Gemini Antigravity Bridge

nandhakumar-murugan14stars

⚡ Bridge connecting Google Gemini Spark & Cloud AI to your local machine via MCP with autonomous file creation, terminal execution, and subagent orchestration.

Cloud Infrastructure

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Gemini Antigravity Bridge

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-28

Stars: 14
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Gemini Antigravity Bridge?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Gemini Antigravity Bridge need an API key?

No required environment variable is listed on this record.

What transport does Gemini Antigravity Bridge use?

Gemini Antigravity Bridge runs locally over stdio.

When was Gemini Antigravity Bridge last checked?

Last checked 2026-10-28. ⚡ Bridge connecting Google Gemini Spark & Cloud AI to your local machine via MCP with autonomous file creation, terminal execution, and subagent orchestration.

From the publisher

Documentation

⚡ Gemini Antigravity Bridge

The World's First Bidirectional MCP Bridge Between Google Gemini Spark & DeepMind Antigravity

Connect Google's cloud AI (Gemini Spark powered by Gemini 3.8 / 3.7) to your local agentic IDE (Antigravity) with 24 powerful MCP tools, hardened by OpenAgentShield Zero-Trust runtime sandboxing and automatic credential redaction.

Quick Start · Architecture · Tools · Connected Apps · Deploy

🌐 What Is This?

Gemini Antigravity Bridge is an MCP (Model Context Protocol) server that creates a persistent, bidirectional communication channel between:

☁️ Google Gemini Spark (cloud-based AI assistant with Google Workspace access, powered by Gemini 3.8 / 3.7)
💻 Google DeepMind Antigravity (local agentic IDE with full system access)

Optimized for Gemini 3.8's next-generation agentic reasoning, this enables a fully autonomous loop where Spark can dispatch coding tasks to your local machine, and Antigravity can request cloud intelligence back from Spark — all through a standardized, secure protocol.

┌──────────────────────────────────────────────────────────────────┐
│                    GEMINI SPARK (Google Cloud)                    │
│  📬 Gmail │ 📁 Drive │ 📅 Calendar │ 🎨 Canva │ 🎥 YouTube     │
└─────────────────────────┬────────────────────────────────────────┘
                          │ MCP over HTTPS
                          ▼
┌──────────────────────────────────────────────────────────────────┐
│              ⚡ GEMINI ANTIGRAVITY BRIDGE (MCP Server)            │
│                                                                  │
│  🔧 System Commands    📂 File Operations    🤖 Agent Dispatch   │
│  🧠 Shared Memory      🔄 Project Sync       📊 Status Reports  │
│                                                                  │
│  Tunnel: ngrok / Cloudflare (permanent HTTPS domain)             │
└─────────────────────────┬────────────────────────────────────────┘
                          │ Local MCP + Message Injection
                          ▼
┌──────────────────────────────────────────────────────────────────┐
│             ANTIGRAVITY IDE (Local Machine)                       │
│  🖥️ Terminal │ 📝 Code Editor │ 🌳 Git │ 🧪 Tests │ 🚀 Deploy  │
└──────────────────────────────────────────────────────────────────┘

🏆 Why This Bridge?

Feature	This Project	Other MCP Servers
Bidirectional Cloud ↔ Local	✅	❌
Autonomous Agent Task Dispatch	✅	❌
Cross-Agent Shared Memory	✅	❌
Antigravity Conversation Injection	✅	❌
Spark Connected Apps Orchestration	✅	❌
Google Workspace Integration	✅ (via Spark)	Partial
Local File System Access	✅	Some
System Command Execution	✅	Some

🚀 Quick Start

Prerequisites

Python 3.10+
ngrok account (free tier) with a reserved domain
Google Gemini Spark (Advanced/Ultra subscription)
Google DeepMind Antigravity IDE

Installation

# Clone the repository
git clone https://github.com/nandhakumar-murugan/gemini-antigravity-bridge.git
cd gemini-antigravity-bridge

# Install dependencies or install package directly
pip install -r requirements.txt
# OR install as a CLI tool:
pip install -e .

# Configure environment
cp .env.example .env
# Edit .env with your NGROK_AUTHTOKEN and NGROK_DOMAIN

# Launch the bridge (via script or CLI)
gemini-bridge
# or: python run_with_tunnel.py

Connect to Gemini Spark

Open Gemini Spark → Settings → Connected Apps
Click "Add a custom app"
Enter your public MCP URL: https://your-domain.ngrok-free.dev/mcp
Spark will discover all 23 tools automatically!

🛠️ Available Tools (24)

🔧 System Execution

Tool	Description
`run_system_command`	Execute shell/PowerShell command with AST risk analysis and captured output
`run_batch_commands`	Run multiple commands sequentially with error handling and policy validation

📂 File Operations

Tool	Description
`read_file`	Read file contents with sensitive credential protection
`write_file`	Create or overwrite files with automatic secret redaction
`edit_file`	Surgically edit specific lines in existing files
`append_file`	Append content to the end of a file
`batch_write_files`	Create multiple files in a single operation with policy enforcement
`create_full_project`	Scaffold an entire project directory structure
`list_directory`	List directory contents with metadata

🤖 Agent Orchestration

Tool	Description
`run_agent_task`	Launch an autonomous Antigravity coding subagent
`get_agent_status`	Check status and output of a running agent task
`terminate_task`	Kill a running agent task

🛡️ Zero-Trust Security & Telemetry (OpenAgentShield)

Tool	Description
`get_security_audit_log`	Retrieves OpenAgentShield Zero-Trust audit events, blocked attacks, and system risk scores (DOI: 10.5281/zenodo.22259022)

🧠 Shared Memory & Sync

Tool	Description
`get_bridge_history`	Retrieve full cross-client operation history with redacted credentials
`save_session_note`	Write a structured note to shared memory (tagged)
`get_session_notes`	Read session notes by tag or date range
`sync_project_to_gemini`	Sync project metadata to Spark's knowledge base
`git_quick_status`	Quick Git status check for any repository

🌐 Spark Connected Apps

Tool	Description
`request_spark_connected_app_action`	Dispatch tasks to Spark's connected apps (@Canva, @YouTube, @Gmail, etc.)
`get_spark_connected_apps_catalog`	List all available connected apps and capabilities

🔗 Antigravity Deep Integration

Tool	Description
`list_antigravity_conversations`	List all active Antigravity IDE conversations
`inject_message`	Inject a structured message directly into an Antigravity conversation
`send_spark_to_antigravity_task`	Dispatch a full task brief from Spark to Antigravity
`get_antigravity_agent_report`	Get the latest execution report for Spark to review

🔄 Spark Connected Apps

Through the bridge, Antigravity can orchestrate Spark's connected Google & third-party apps:

App	Capabilities
🎨 @Canva	Poster design, infographics, slide decks
📁 @Google Drive	Cloud file search, folder management
📝 @Google Docs	Document creation and collaboration
📌 @Google Keep	Quick notes, flashcards, checklists
🎥 @YouTube	Video search, transcript extraction
📬 @Gmail	Email reading, URL extraction
📓 @Gemini Notebook	Deep research and synthesis
📦 @Dropbox	Cloud storage sync via MCP

🏗️ Architecture

graph TB
    subgraph Cloud["☁️ Google Cloud"]
        Spark["Gemini Spark<br/>Consumer AI Assistant"]
        Gmail["📬 Gmail"]
        Drive["📁 Google Drive"]
        Calendar["📅 Google Calendar"]
        Canva["🎨 Canva"]
    end

    subgraph Bridge["⚡ Antigravity Bridge"]
        MCP["MCP Server<br/>(FastMCP + Starlette)"]
        Tunnel["HTTPS Tunnel<br/>(ngrok / Cloudflare)"]
        Memory["🧠 Shared Memory<br/>(bridge_history.json)"]
        Dashboard["📊 Web Dashboard"]
    end

    subgraph Local["💻 Local Machine"]
        AGY["Antigravity IDE"]
        Terminal["🖥️ Terminal"]
        Git["🌳 Git Repos"]
        Files["📂 File System"]
    end

    Spark -->|"MCP over HTTPS"| Tunnel
    Tunnel --> MCP
    MCP -->|"inject_message"| AGY
    MCP -->|"run_system_command"| Terminal
    MCP -->|"git_quick_status"| Git
    MCP -->|"read/write_file"| Files
    MCP --> Memory
    AGY -->|"save_session_note"| Memory
    Memory -->|"get_agent_report"| Spark
    Spark --> Gmail
    Spark --> Drive
    Spark --> Calendar
    Spark --> Canva

🚢 Deployment

Auto-Start on Windows Boot

The bridge includes a silent startup script that launches automatically when you log in:

📁 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\
└── GeminiAntigravityBridge.vbs  (silent background launcher)

Cloud Deployment (24/7 Uptime)

# Using Docker
docker build -t gemini-antigravity-bridge .
docker run -d -p 8000:8000 --env-file .env gemini-antigravity-bridge

# Using Render.com / Google Cloud Run
# Push to GitHub → Connect repo → Deploy automatically

📋 Scheduled Monitoring

The bridge supports multi-tier automated monitoring via Gemini Spark schedules:

Tier	Cadence	Purpose
🔴 Instant Trigger	Real-time (on email arrival)	Zero-delay alerts for college & NPTEL emails
🟡 Hourly Sweep	Every 60 minutes	Broad monitoring across all platforms
🟢 Morning Briefing	Daily @ 8:00 AM	Strategic daily plan with exam schedules

🤝 Contributing

Contributions are welcome! Please read the Apache 2.0 License before submitting PRs.

Fork the repository
Create your feature branch (git checkout -b feat/amazing-feature)
Commit your changes (git commit -m 'feat: add amazing feature')
Push to the branch (git push origin feat/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

📚 Research Paper & Academic Citation

This framework implements the formal architecture introduced in the published research paper:

AgentShield: A Zero-Trust Runtime Guardrail Architecture for Autonomous Multi-Agent AI Systems with Bidirectional Context Synchronization
Nandhakumar Murugan
Department of Computer Science and Engineering (Cybersecurity), KGiSL Institute of Technology (KiTE), Autonomous
Permanent DOI: 10.5281/zenodo.22259022 | Open Access: Zenodo CERN Repository

If you reference or build upon this architecture in academic or enterprise research, please cite:

@article{murugan2026agentshield,
  title={AgentShield: A Zero-Trust Runtime Guardrail Architecture for Autonomous Multi-Agent AI Systems with Bidirectional Context Synchronization},
  author={Murugan, Nandhakumar},
  journal={Zenodo},
  year={2026},
  doi={10.5281/zenodo.22259022},
  url={https://doi.org/10.5281/zenodo.22259022}
}

👨‍💻 Author

Nandhakumar Murugan
B.E. Computer Science & Cyber Security | KGiSL Institute of Technology
Google Student Ambassador (GID: 36) | Open Source Contributor

Built with ❤️ using Google Gemini, DeepMind Antigravity & Model Context Protocol