Set up Gemini¶
Connect Google’s Gemini agents to the Amperity MCP server and sign in with your Amperity credentials. This page covers two clients:
Antigravity – Google’s agentic IDE.
Gemini CLI – the command-line agent.
Antigravity¶
Connect Antigravity to the Amperity MCP server by adding it as a custom remote MCP server and signing in with your Amperity credentials.
Requirements¶
Connecting Antigravity to the MCP server requires:
An active Amperity account with access to at least one tenant.
Antigravity installed and signed in.
Add the Amperity MCP server¶
Register the Amperity MCP server as a custom server in your Antigravity configuration.
Open your global Antigravity MCP configuration file at
~/.gemini/config/mcp_config.json.Add the
amperityserver with Amperity’s OAuth client ID:{ "mcpServers": { "amperity": { "serverUrl": "https://mcp.amperity.com", "oauth": { "clientId": "nwbd0MGCyh1VysmYQM05UoDXIuVPdGEs" } } } }
Important
Antigravity requires the
serverUrlfield for remote servers; theurlandhttpUrlfields are not supported. Theoauth.clientIdfield is required so Antigravity surfaces the Authenticate button.
Authenticate¶
Click Settings at the bottom left, then select the Customizations tab.
Under Installed MCP Servers, click Authenticate next to the amperity server. A browser tab opens. Sign in with your Amperity OAuth credentials and select your tenant.
Copy the authorization code from the browser, paste it back into the settings panel, and click Submit. The server reconnects automatically and its tools become available.
Start interacting with Antigravity¶
In an Antigravity agent session, ask:
"Tell me about my Amperity tenant."
Antigravity calls the tenant_info tool and returns details about your current Amperity tenant.
Gemini CLI¶
Connect Gemini CLI to the Amperity MCP server by adding it as a remote MCP server and signing in with your Amperity credentials.
Important
Gemini CLI only works for organizations on a Gemini Code Assist Standard or Enterprise license.
Requirements¶
Connecting Gemini CLI to the MCP server requires:
An active Amperity account with access to at least one tenant.
Gemini CLI installed and signed in.
Add the Amperity MCP server¶
Register the Amperity MCP server in your Gemini CLI configuration.
Add the server:
gemini mcp add --transport http --scope user amperity https://mcp.amperity.comAdd Amperity’s OAuth client ID to the server entry. Open
~/.gemini/settings.jsonand add anoauthblock to theamperityserver so it matches the following:{ "mcpServers": { "amperity": { "httpUrl": "https://mcp.amperity.com", "oauth": { "clientId": "nwbd0MGCyh1VysmYQM05UoDXIuVPdGEs", "authorizationUrl": "https://mcp.amperity.com/authorize", "tokenUrl": "https://mcp.amperity.com/oauth/token" } } } }
Important
The
oauth.clientIdfield is required. Without it, Gemini CLI cannot authenticate to the Amperity MCP server.
Authenticate¶
Start Gemini CLI, or restart it if it was already running, so it reloads
settings.json:geminiTrigger the OAuth flow:
/mcp auth amperityA browser tab opens. Sign in with your Amperity OAuth credentials. Gemini CLI reports a successful authentication and reloads the Amperity tools.
Verify the server is connected:
/mcpThe amperity server appears with its available tools.
Start interacting with Gemini CLI¶
In a Gemini CLI session, ask:
"Tell me about my Amperity tenant."
Gemini CLI calls the tenant_info tool and returns details about your current Amperity tenant.