By Google

Connect Google Antigravity to your task board

Give your Antigravity agents a shared board.

To connect Google Antigravity to a task board, add Weft — a task board with an MCP server — to Google Antigravity and sign in once. It takes about three minutes and is free for 50 tasks. After that, Google Antigravity creates, moves and finishes tasks on your board when you ask.

Weft is the AI task manager for solo founders and small teams.

Google's agentic development platform, powered by Gemini 3. Its agents plan and ship on their own — Weft gives them a shared board with receipts, so what they finished waits for your verdict instead of scrolling away in a chat.

Google Antigravity MCP setup

Google Antigravity MCP docs ↗

The editor, the app and the CLI share the same MCP config, but not the sign-in: press Authenticate once on each one you use.

  1. 01

    Create a free Weft account.

    Weft is free for 50 tasks. Pro from $5/seat/month billed yearly.

  2. 02

    Add Weft to your Google Antigravity config.

    ~/.gemini/config/mcp_config.json
    {
      "mcpServers": {
        "weft": {
          "serverUrl": "https://letsweft.com/api/mcp"
        }
      }
    }
    MCP endpoint
    https://letsweft.com/api/mcp
  3. 03

    Complete the OAuth popup.

    On first use, Google Antigravity opens a browser window so you can authorize with your Weft account. Sign in once — the client remembers you after that.

  4. 04

    Verify it works.

    Open Agent Settings (Cmd+,) → Customizations, click "Authenticate" next to weft, finish OAuth in the browser and paste the code back. Then ask the agent: "what's on my board?".

How MCP works in Antigravity

Google Antigravity reads MCP servers from an mcp_config.json file and connects to remote servers over Streamable HTTP, handling the OAuth sign-in itself — no mcp-remote bridge needed. Here is where the file lives, the format for a remote server, and what to do when a server will not connect.

Where the config lives

  • Global: ~/.gemini/config/mcp_config.json. Per workspace: <workspace>/.agents/mcp_config.json.
  • From the editor: “…” at the top of the agent side panel → MCP Servers → Manage MCP Servers → View raw config.
  • In the Antigravity app: Customizations → Installed → MCP Servers → +. In the CLI: /mcp.
  • Some third-party guides give ~/.gemini/antigravity/mcp_config.json; Google’s docs use the paths above.

Remote server format

Put the endpoint in serverUrl (url also works). httpUrl and the legacy HTTP+SSE transport are not supported. timeoutSeconds is optional.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "weft": {
      "serverUrl": "https://letsweft.com/api/mcp"
    }
  }
}

Signing in

For servers that support dynamic client registration — Weft does — Antigravity runs OAuth 2.0 with PKCE on its own: press Authenticate next to the server. In the app you paste the authorization code back and press Submit. Tokens refresh automatically. The editor, app and CLI share the config file but not the sign-in, so authenticate on each one you use.

Limits

Antigravity waits up to 300 seconds to connect and list tools, and 180 seconds per tool call; timeoutSeconds in the server’s entry overrides both. Weft’s tools load like any other server’s, and you can hide some with disabledTools.

Troubleshooting

Weft shows “Unauthorized”
Press Authenticate next to it and finish the sign-in in the browser.
“Blocked by Admin Policy”
Your organization allow-lists MCP servers. An admin has to add https://letsweft.com/api/mcp to the list.
“timed out after 3m0s”
Raise timeoutSeconds in Weft’s entry in mcp_config.json, then refresh the server.
Weft does not appear after editing the file
Press Refresh under Installed MCP Servers, or reload the configuration from /mcp in the CLI. Check the key is serverUrl, not httpUrl.
Is Weft in the Antigravity MCP Store?
Not yet. Add it as a custom server with the config above — it takes a minute.

Sources: Google — MCP in Antigravity · Google — Antigravity plugins (agy CLI) · Google codelab — Workspace MCP in Antigravity

Try these prompts

Everything below works once you’re connected — Google Antigravity picks the right Weft tool on its own.

  • “What's on my board right now?”
  • “Create a task for every TODO you just left in the code.”
  • “Claim the top task from Todo and report progress as you go.”
  • “What finished work is waiting for my review?”

Google Antigravity and MCP: common questions

Does Google Antigravity support MCP?

Yes. Google Antigravity connects to remote MCP servers, and Weft is one: a single endpoint, https://letsweft.com/api/mcp. You sign in once in the browser; there is no API key to copy.

Where do I add an MCP server in Google Antigravity?

In ~/.gemini/config/mcp_config.json. The snippet in step 2 is the whole Weft entry.

Is Weft free to use with Google Antigravity?

Yes, for up to 50 tasks, with no credit card. Pro removes the limit.

What can Google Antigravity do on my Weft board?

Create, update, move and complete tasks, plan and run sprints, sort work into projects and search across all of it: 32 MCP tools in all.

Learn more about Weft

All integrations

Put Google Antigravity on your board.

Start free with 50 tasks. Upgrade when your AI fills the Backlog.

Trouble connecting? Contact support