# Google Antigravity

> Connect Google Antigravity, the app and the `agy` CLI, to Korala with a browser sign-in.

Source: https://docs.korala.ai/ai-agents/antigravity

---

  The steps below follow Antigravity's current documentation and the Antigravity CLI 1.2 (checked 2026-09-22); menu names can change.

## Antigravity CLI

1. Add the server:

   ```bash
   agy mcp add korala https://api.korala.ai/mcp
   ```

2. Start `agy`, run `/mcp` and sign in next to **korala**. Antigravity opens a browser.
3. Approve the connection on Korala's consent page. See [Permissions and safety](https://docs.korala.ai/ai-agents/permissions).

The sign-in needs an interactive session. Run it once; Antigravity keeps the token and refreshes it.

## Antigravity app and IDE

Antigravity reads MCP servers from `~/.gemini/config/mcp_config.json`, which the app, the IDE and the CLI share. `agy mcp add` above adds Korala to all three. To edit the file yourself:

- **Antigravity app:** open **Settings** at the bottom left, then **Customizations**. Installed MCP servers are listed there.
- **Antigravity IDE:** open the **…** menu at the top of the agent panel, choose **MCP Servers**, then **Manage MCP Servers** and **View raw config**.

Add Korala to `mcpServers`. Antigravity names the key `serverUrl`:

```json
{
  "mcpServers": {
    "korala": {
      "serverUrl": "https://api.korala.ai/mcp"
    }
  }
}
```

To sign in:

1. Open **Customizations** in Agent Settings and choose **Authenticate** next to **korala**.
2. Sign in to Korala in the browser and approve the connection on the consent page.
3. Copy the authorization code the browser shows, paste it into the settings panel and choose **Submit**.

  We have signed in through the Antigravity CLI. We have not tried the app's sign-in yet; if it fails, sign in with `agy` as above.

For one project only, put the same block in `.agents/mcp_config.json` in the workspace.

## The Korala plugin

The Korala plugin for Antigravity bundles the same server with a skill and rules that tell the agent how to draft, prepare, send and track documents. Antigravity installs plugins from a folder:

```bash
agy plugin install ./korala
```

Then sign in with `/mcp` as above.

  The plugin folder is not published yet, and Antigravity has no public plugin marketplace we can list it in. Until it is published, use `agy mcp add` above.

If you installed the [Gemini CLI extension](https://docs.korala.ai/ai-agents/other-clients#gemini-cli), `agy plugin import gemini` brings its server across. It does not bring the skill.

## API key alternative

For machines where nobody can open a browser:

```bash
agy mcp add \
  -e KORALA_API_KEY_ID=your-key-id \
  -e KORALA_API_SECRET=your-secret \
  korala-local npx -y @korala/mcp
```

Put the flags before the server name. See [API key (CI and headless)](https://docs.korala.ai/ai-agents/api-key).