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.

Access tokens expire after 30 days. Compatible clients refresh the connection automatically before expiry. If refresh expires or fails, reconnect in your AI client.

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.