# Codex CLI Financial Data Integration | Warm

> Connect your bank accounts to OpenAI Codex CLI. Query transactions, balances, and subscriptions with natural language via MCP.

Source: https://warm.io/codex-finance

Pro Exclusive

Ask OpenAI Codex CLI about your spending, accounts, and subscriptions. Get real answers from your actual financial data via MCP.

[Get Pro for $24.99/mo](https://warm.io/pricing.md) [View Full Documentation](https://warm.io/developers.md)

Read-only access · Revoke anytime · Works with [Claude Code](https://warm.io/claude-code-finance.md), [Cursor](https://warm.io/cursor-finance.md) & more

## Setup in seconds.

Add this to your Codex CLI configuration file.

.codex/config.json

                    `{   "mcpServers": {     "warm": {       "command": "npx",       "args": ["-y", "@warmio/mcp", "--server"],       "env": {         "WARM_API_KEY": "your-api-key"       }     }   } }`


Get your API key from [Settings → API Keys](https://warm.io/settings)

## MCP Tools available.

Codex CLI 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 on food last month?"

`get_financial_state`

Read snapshots, recurring payments, budgets, goals, health, liabilities, holdings, and category spending in one call

"Show my net worth, recurring charges, budgets, and goals"

`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 fetches your accounts via get\_accounts, displaying names, types, institutions, and current balances.

### Spending Analysis

"How much did I spend on restaurants last month?"

Codex 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?"

Codex 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?"

Codex uses get\_financial\_state to review your snapshots and net worth trend alongside the rest of your current financial state.

## What Codex 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 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", "--server"\], and add your WARM\_API\_KEY from Settings → API Keys. Codex will automatically discover the tools.

### What financial data can Codex access?

Codex 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 Codex modify my data?

The MCP server is strictly read-only. Codex 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 Codex CLI support MCP?

Yes. OpenAI 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.

### 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

[Claude Code Integration →](https://warm.io/claude-code-finance.md) [Cursor Integration →](https://warm.io/cursor-finance.md) [Windsurf Integration →](https://warm.io/windsurf-finance.md) [Full Documentation →](https://warm.io/developers.md)

## Ready to ask Codex CLI
about your money?

Your financial data, accessible in your AI terminal workflow.

[Get Pro for $24.99/mo](https://warm.io/pricing.md) [View Documentation](https://warm.io/developers.md)

MCP access is exclusive to Pro. It is not included with Plus.
