Warm MCP for Cursor

Query Warm financial data from Cursor

Query your bank accounts, transactions, and subscriptions without leaving your IDE. Financial MCP tools for developers who live in Cursor.

Install Warm MCP See pricing

Local @warmio/mcp package · Read-only tools · Scoped API keys · Revoke anytime

Local package

Start the local Warm MCP installer, then connect the client with your scoped API key.

Terminal shell 
npx @warmio/mcp
  • Read-only MCP tools
  • Scoped Warm API key
  • Revocable from Settings

Client config

The client launches @warmio/mcp locally. Warm does not require a hosted remote MCP endpoint.

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

MCP setup

Add to Cursor.

Create this file in your project root.

  1. 1. Create an API key Get it from Settings → API Keys.
  2. 2. Run the installer Use npx @warmio/mcp.
  3. 3. Reload the client Restart or reload so the Warm tools are discovered.
  4. 4. Verify with a prompt Ask: "Is my Warm connection working?"
Terminal shell 
npx @warmio/mcp
Manual config

Use this only if you prefer editing the client config yourself.

.cursor/mcp.json json 
{
  "mcpServers": {
    "warm": {
      "command": "npx",
      "args": ["-y", "@warmio/mcp", "--server"],
      "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_accounts, get_transactions, get_financial_state, or verify_key.

Tip: You can also add this to your user-level Cursor settings for global access across all projects.

Developer workflows.

Check your finances without context switching.

Context-Aware Coding

"I need to budget $500 for this SaaS tool. Show my current subscriptions."

While evaluating tools for your project, quickly check your current subscription spend without leaving your IDE.

Quick Financial Checks

"Do I have enough in checking for this cloud hosting bill?"

Get account balances instantly while planning infrastructure costs or making purchasing decisions.

Spending Research

"How much have I spent on developer tools this quarter?"

Cursor analyzes your transactions by category to help with expense reports or budget planning.

Financial Debugging

"Why is my checking account lower than expected?"

Get recent transactions and recurring charges to understand where your money is going.

MCP Tools included.

Cursor automatically discovers and uses these tools.

get_accounts

List connected financial accounts with balances, types, and institutions

"Show my connected accounts and current balances"

get_financial_state

Read snapshots, recurring payments, budgets, goals, and health in one bundle

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

get_transactions

Read transaction history with strict cursor pagination

"Show me my transactions from last week"

verify_key

Check if your Warm API key is valid and working

"Test my Warm MCP connection"

Data access.

Available via MCP

  • Accounts (names, types, balances, institutions)
  • Transactions (amounts, merchants, categories, dates)
  • Recurring payments and subscriptions
  • Net worth snapshots over time
  • Budgets, goals, financial health, liabilities, and holdings

Not Exposed (App Only)

  • — Conversation history
  • — Household sharing settings
  • — API key management
  • — Any write operations

Secure by design.

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 Cursor and Warm.

How do I add Warm to Cursor?

Create a .cursor/mcp.json file in your project root 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. Cursor will automatically discover the tools.

What financial data can Cursor access?

Cursor 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. Conversation history and household/sharing settings remain app-only.

Can Cursor modify my financial data?

No. The MCP server is strictly read-only. Cursor cannot modify, delete, or transfer any data. Your API key is scoped to only your accounts, and you can revoke it instantly from Settings.

Does this work with Cursor Agent?

Yes. The MCP tools work with both Cursor chat and Cursor Agent. You can ask financial questions while coding and get answers without switching context.

Can I use this in any project?

Yes. Add the .cursor/mcp.json config to any project, or create a global config. The MCP server is project-agnostic—it connects to your Warm account, not your code.

Which plan includes this?

MCP is available on paid Warm plans. Pro supports up to 30 synced accounts.

More Ways to Connect

Claude Code Integration → Windsurf Integration → All MCP clients → Full Documentation →

Ready to query finances
from Cursor?

Your financial data, right where you code.

See pricing View Documentation

MCP is available on paid Warm plans. Pro supports up to 30 synced accounts.