Connect finerd to Antigravity CLI

What it does

Antigravity CLI (agy) is Google’s successor to Gemini CLI — same MCP workflow, new tooling. Gemini CLI sunsets June 18, 2026 for consumer accounts; enterprise users can keep using it.

Lets Antigravity CLI query and edit your finerd ledger — spending, accounts, transactions, bills, reports, and tags. Works as a remote MCP server with OAuth.

Prerequisites

Antigravity CLI installed (install instructions).

How to connect

Fast track

Antigravity CLI — paste this prompt and the agent sets it up for you:

Set up the Finerd MCP server for me: run `agy plugin install https://github.com/finerd-Inc/mcp`, complete the browser OAuth login, and confirm the Finerd tools are available with /mcp.

Install the Finerd plugin:agy plugin install https://github.com/finerd-Inc/mcp
A browser window opens for the finerd OAuth flow on first tool call.
Sign in with your finerd account.
Choose access level (Read-only or Read & Write).
Alternative — paste the server URL directly:https://api.finerd.ai/mcp

Using the Antigravity IDE (2.0) instead of the CLI? In the IDE, a native remote server URL currently fails after sign-in (a known Antigravity issue — the IDE does not attach the token to its requests). Instead, add Finerd as a command-based (stdio) server that runs the mcp-remote wrapper — it performs the browser sign-in and attaches the token itself. You need Node.js installed (so the npx command is available). Open the IDE MCP config (Settings → MCP, or edit ~/.gemini/antigravity/mcp_config.json) and add the finerd server exactly like this:

{ "mcpServers": { "finerd": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.finerd.ai/mcp"] } } }

Save and restart the server in the IDE. On first use a browser window opens for the Finerd sign-in; after you approve, the Finerd tools work in the IDE.

Permissions

You pick at sign-in time:

Read-only — Antigravity can read your data but not modify it. Good default for "ask my finances" use cases.
Read & Write — Antigravity can also create, edit, and delete transactions, transfers, and tags.

The connector token expires automatically after 30 days; sign in again to renew.

What Antigravity can do (read)

Search Transactions — filter by date, category, account, or text
Get Transaction — full details with journal breakdown
List Accounts — your bank accounts, wallets, debts
List Categories — expense and income categories
List Bills — receipts and invoices with line items
Get Bill — full bill details
Search Merchants — find merchants by name
Search Tags — find tags by name
List Spaces — your available spaces (Personal / Business)
Get Account Balances — balance per account at any date
Get Expense / Income / Cash Flow / Net Worth Reports — aggregated views
Verified Balances — your manually confirmed account balances
Asset Rates — currency and asset exchange rates

What Antigravity can do (write, requires Read & Write access)

Create / Update / Delete Transaction — record or fix expenses, incomes, refunds, debt-pays
Create Complex Transaction — split transactions across multiple categories or accounts
Create Transfer — record an internal transfer between two of your tracked finerd accounts (this is a ledger entry in finerd — it does not move real money or interact with your bank)
Create / Update Tag — manage your tag taxonomy
Manage Rewards & Points — record points earnings, monthly accruals, and redemptions on reward accounts
Create Accounts — add cash, bank, debt, and reward accounts

What Antigravity cannot do

Move actual funds anywhere — finerd is a personal ledger; banks are read-only sources.
Access other users' data — every request is scoped to your account.
Read your Antigravity conversation history or files.

Privacy & data

Antigravity only sees data from the space you ask it about. We don't log conversation content. See https://finerd.ai/privacy-policy and https://finerd.ai/security.

Example prompts

"Can we afford a week trip to Barcelona in July at our current savings rate?"
"Analyze my spending by category — which credit card would maximize my rewards?"
"What were my top 5 food merchants last month? Break it down by week."
"Tag all my transactions from Apr 1–10 as 'NY trip'."
"Spread this $300 annual subscription evenly across the year."

Disconnect

You can revoke access by running agy plugin uninstall finerd.

Troubleshooting

If connection fails, try disconnecting and reconnecting in Antigravity. Contact [email protected] for help.