Ask Aider about your spending, accounts, and subscriptions. Get real answers from your actual financial data via MCP in your terminal.
Read-only access · Revoke anytime · Works with Claude Code, Cursor & more
Setup in seconds.
Run Aider with the MCP server flag, or add to your config.
WARM_API_KEY=your-api-key aider --mcp-server "npx -y @warmio/mcp --server"
{
"mcpServers": {
"warm": {
"command": "npx",
"args": ["-y", "@warmio/mcp", "--server"],
"env": {
"WARM_API_KEY": "your-api-key"
}
}
}
}
Get your API key from Settings → API Keys
MCP Tools available.
Aider automatically discovers and uses these tools.
get_accounts List all connected financial accounts with balances, types, and institutions
"Show me all my accounts"
get_transactions Read transaction history with strict cursor pagination
"What did I spend last week?"
get_financial_state Read snapshots, recurring payments, budgets, goals, health, liabilities, holdings, and category spending in one call
"Show my subscriptions, net worth, budgets, and goals"
verify_key Check if your Warm API key is valid and working
"Test my Warm connection"
Ask Aider anything.
Real examples of what you can do with your financial data.
Account Overview
"Show me all my bank accounts and balances"
Aider fetches your accounts via get_accounts, displaying names, types, institutions, and current balances in your terminal.
Spending Analysis
"How much did I spend on restaurants this month?"
Aider uses get_transactions to page through transaction history, categorize spending, and give you totals with merchant breakdowns.
Subscription Audit
"What recurring charges am I paying?"
Aider uses get_financial_state to review your recurring charges and subscription totals alongside the rest of your current financial state.
Net Worth Tracking
"What's my net worth trend over the past 6 months?"
Aider uses get_financial_state to review your snapshots and net worth trend alongside the rest of your current financial state.
What Aider can see.
Available via MCP
- Accounts (names, types, balances, institutions)
- Transactions (amounts, merchants, categories, dates)
- Recurring payments and subscriptions
- Net worth snapshots over time
Not Exposed (App Only)
- — Budgets and budget progress
- — Savings goals
- — AI chat history
- — Any write operations
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 Aider and Warm.
How do I add Warm to Aider?
Aider supports MCP servers via the --mcp-server flag or config file. Run: WARM_API_KEY=your-key aider --mcp-server "npx -y @warmio/mcp --server". Or add the config to ~/.aider/mcp.json for persistent access.
What financial data can Aider access?
Aider can access your accounts (balances, types, institutions), transactions (amounts, merchants, categories, dates), and financial state: snapshots, recurring payments, budgets, goals, financial health, liabilities, investment holdings, and category spending. AI chat history and household/sharing settings remain app-only.
Is this safe? Can Aider modify my data?
The MCP server is strictly read-only. Aider cannot modify, delete, or transfer any data. Your API key is scoped to only your accounts, and you can revoke it instantly from Settings if needed.
Does Aider work with different AI models?
Yes. Aider works with Claude, GPT-4, and other models. The Warm MCP tools are available regardless of which underlying model you use with Aider.
Do I need to install anything?
You need Node.js 18+ installed. The MCP server runs via npx @warmio/mcp, so there's no global installation required. Just add the config and your API key.
Is this feature free?
No, the MCP server and API access are exclusive to Warm Pro ($24.99/mo). Free and Plus tiers do not include API access.
More Ways to Connect
Ready to ask Aider
about your money?
Your financial data, accessible in your terminal workflow.
MCP access is exclusive to Pro. It is not included with Plus.