Ask Claude Code about your money
Ask Claude Code 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 Claude Code configuration file.
- 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.
Claude Code automatically discovers and uses these tools.
get_financial_context Read normalized financial context beyond individual transactions, including accounts at status.accounts
"Show my connected accounts and current balances"
get_transactions Read transactions for month YYYY-MM or latest:true; bare calls use the fixed 10-day latest window
"What did I spend on groceries last month?"
verify_key Check if your Warm API key is valid and working
"Is my Warm connection working?"
Ask Claude Code anything.
Real examples of what you can do with your financial data.
Account Overview
"Show me all my bank accounts and their balances"
Claude 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 last month?"
Claude 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?"
Claude 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 Claude Code and Warm.
How do I add Warm to Claude Code?
Add the MCP server config to your claude_desktop_config.json file. Set the command to "npx", args to ["-y", "@warmio/mcp@latest", "mcp"], and add your WARM_API_KEY from Settings → API Keys. Claude Code should then discover the tools.
What financial data can Claude Code access?
Claude Code 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 Claude modify my data?
The MCP server is strictly read-only. Claude 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.
What Claude Code commands can I use?
Just ask questions naturally. Claude Code can use get_financial_context for normalized account and financial context, get_transactions for month YYYY-MM or latest:true (or a bare fixed 10-day latest window), and verify_key to confirm the connection.
Ready to ask Claude Code
about your money?
Your financial data, accessible in your MCP workflow.
MCP and API access are included on both Warm plans. Plus includes up to 5 synced accounts. Pro includes up to 30 synced accounts.