Ask Gemini CLI about your money
Ask Google Gemini CLI about your spending, accounts, and subscriptions. Get real answers from your actual financial data via MCP.
Local @warmio/mcp package · Read-only tools · User-scoped API keys · Revoke anytime
MCP setup
Setup in seconds.
Add this to your Gemini CLI MCP configuration.
- 1. Create an API key Get it from Settings → API Keys.
- 2. Run the installer
Use
npx -y @warmio/mcp@latest. - 3. Reload the client Restart or reload so the Warm tools are discovered.
- 4. Verify with a prompt Ask: "Is my Warm connection working?"
npx -y @warmio/mcp@latestManual config
Use this only if you prefer editing the client config yourself.
{
"mcpServers": {
"warm": {
"command": "npx",
"args": ["-y", "@warmio/mcp@latest", "mcp"],
"env": {
"WARM_API_KEY": "your-api-key"
}
}
}
} Verify: ask the client to show your Warm
accounts or test the Warm connection. It should call get_financial_context,
get_transactions,
or verify_key.
MCP Tools available.
Gemini CLI automatically discovers and uses these tools.
get_financial_context Read normalized financial context beyond individual transactions, including accounts at status.accounts
"Show my subscriptions, net worth, budgets, and goals"
get_transactions Read transactions for month YYYY-MM or latest:true; bare calls use the fixed 10-day latest window
"What did I spend last month?"
verify_key Check if your Warm API key is valid and working
"Test my Warm connection"
Ask Gemini anything.
Real examples of what you can do with your financial data.
Account Overview
"Show me all my bank accounts and balances"
Gemini CLI uses get_financial_context to read accounts from status.accounts, including names, types, institutions, and balances.
Spending Analysis
"How much did I spend on restaurants this month?"
Gemini uses get_transactions with month YYYY-MM or latest:true to review transactions, categorize spending, and give you totals with merchant breakdowns. Bare calls use the fixed 10-day latest window.
Subscription Audit
"What recurring charges am I paying?"
Gemini uses get_financial_context to query your recurring charges and subscription totals alongside the rest of your financial context.
Safe and secure.
Your financial data stays protected.
Read-Only Access
The MCP server can only query data—never modify, delete, or transfer.
Scoped API Keys
Your key only accesses your accounts. Nothing else.
Instant Revocation
Delete your API key in Settings and access stops immediately.
Common questions
Everything you need to know about Gemini CLI and Warm.
How do I add Warm to Gemini CLI?
Create an MCP config file with the server configuration. Set the command to "npx", args to ["-y", "@warmio/mcp@latest", "mcp"], and add your WARM_API_KEY from Settings → API Keys. Gemini CLI should then discover the tools.
What financial data can Gemini CLI access?
Gemini CLI can access normalized financial context, including accounts at status.accounts, recurring charges, budgets, goals, and financial history, plus transactions for month YYYY-MM or the fixed 10-day latest window. Conversation history and app settings remain app-only.
Is this safe? Can Gemini modify my data?
The MCP server is strictly read-only. Gemini CLI cannot modify, delete, or transfer any data. Your API key is user-scoped to your Warm account, not a set of granular permissions, and you can revoke it instantly from Settings if needed.
Does Gemini CLI support MCP?
Yes. Google's Gemini CLI supports the Model Context Protocol (MCP) for extending its capabilities with external tools like Warm's financial data access.
Ready to ask Gemini
about your money?
Your financial data, accessible with Gemini CLI.
MCP and API access are included on both Warm plans. Plus includes up to 5 synced accounts. Pro includes up to 30 synced accounts.