Ask Codex CLI about your money
Ask Codex 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 Codex CLI 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.
Codex CLI 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 food last month?"
verify_key Check if your Warm API key is valid and working
"Is my Warm connection working?"
Ask Codex anything.
Real examples of what you can do with your financial data.
Account Overview
"Show me all my bank accounts and their balances"
Codex 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?"
Codex 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?"
Codex 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 Codex CLI and Warm.
How do I add Warm to Codex CLI?
Create a .codex/config.json file in your project or home directory with the MCP server config. Set the command to "npx", args to ["-y", "@warmio/mcp@latest", "mcp"], and add your WARM_API_KEY from Settings → API Keys. Codex should then discover the tools.
What financial data can Codex access?
Codex 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 Codex modify my data?
The MCP server is strictly read-only. Codex 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 Codex CLI support MCP?
Yes. Codex CLI supports MCP servers through its config file. The Warm MCP server works just like any other MCP integration—Codex auto-discovers and uses the available tools.
Ready to ask Codex CLI
about your money?
Your financial data, accessible in your terminal 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.