# Ask AI about your finances

Open Source · MIT License
⚠ Unofficial · Not affiliated with Copilot Money

Connect your Copilot Money data to Claude, Cursor, Codex CLI, and more. This project is an independent integration — it is not built, endorsed, or supported by Copilot Money.

Heads up: when you use this with an AI client (Claude, Cursor, Codex CLI, etc.), your Copilot Money data — transactions, balances, accounts — is sent to that AI provider so the model can answer your questions. This project has no servers and collects nothing, but the AI provider you choose is a third party that will see your financial data. Review their privacy policy before connecting.
Download for Claude Desktop Other Clients
17
AI Tools
100%
Local Reads
0
Middlemen
100%
Open Source
Get Started

## Install in 2 minutes

Choose your AI client and follow the steps below. (ChatGPT Desktop only supports remote HTTPS MCP servers, so it can't use this local-stdio server directly — use Codex CLI for OpenAI tooling.)

### Claude Desktop (one-click install)

1 Download the .mcpb bundle

Get the latest `.mcpb` file from GitHub Releases.

2 Double-click to install

Double-click the `.mcpb` file. Claude Desktop will install it automatically — no terminal, no config file editing.

3 Restart Claude Desktop and start asking!

"How much did I spend on food this month?" — Claude will use your Copilot Money data to answer.

### OpenAI Codex CLI

1 Install the package
npm install -g copilot-money-mcp
2 Add to Codex config

Edit `~/.codex/config.toml` (TOML format):

[mcp_servers.copilot_money] command = "copilot-money-mcp"
3 Start Codex and ask about your finances!

### Google Gemini CLI

1 Install the package
npm install -g copilot-money-mcp
2 Add to Gemini CLI settings

Edit `~/.gemini/settings.json`:

{ "mcpServers": { "copilot-money": { "command": "copilot-money-mcp" } } }
3 Start Gemini CLI and ask about your finances!

### Cursor

1 Install the package
npm install -g copilot-money-mcp
2 Add to Cursor config

Edit `~/.cursor/mcp.json`:

{ "mcpServers": { "copilot-money": { "command": "copilot-money-mcp" } } }
3 Restart Cursor and start asking!

### VS Code (built-in MCP, 1.102+)

1 Open the user MCP config

Press `Cmd+Shift+P` and run MCP: Open User Configuration (or create `.vscode/mcp.json` in your workspace).

2 Add the server

VS Code uses a top-level `"servers"` key and `"type": "stdio"`:

{ "servers": { "copilot-money": { "type": "stdio", "command": "npx", "args": ["-y", "copilot-money-mcp"] } } }
3 Use in Copilot Chat!

### Windsurf

1 Install the package
npm install -g copilot-money-mcp
2 Add to Windsurf config

Edit `~/.codeium/windsurf/mcp_config.json`:

{ "mcpServers": { "copilot-money": { "command": "copilot-money-mcp" } } }
3 Restart Windsurf and start asking!

### Cline (VS Code Extension)

1 Install the package
npm install -g copilot-money-mcp
2 Add in Cline MCP settings

Open Cline sidebar → MCP Servers → Add Server. Set Command to:

copilot-money-mcp
3 Start a conversation and ask about your finances!

### Any MCP Client (via npx)

1 Add to your client's MCP config

Using `npx` means no install step needed — it downloads and runs `copilot-money-mcp` on demand:

{ "mcpServers": { "copilot-money": { "command": "npx", "args": ["-y", "copilot-money-mcp"] } } }
2 Restart your client and start asking!

Prefer a global install? Run `npm install -g copilot-money-mcp` and swap `"npx"` for `"copilot-money-mcp"` (and drop `"-y", "copilot-money-mcp"` from args).

See it in action

## What can you do?

Ask natural language questions about your spending, investments, budgets, and more.

### Analyze your spending

"How much did I spend on groceries last month?" — Get instant breakdowns by category, merchant, or time period. Spot trends and outliers effortlessly.

Your browser doesn't support HTML video. Download the demo.

Features

## Everything you need

17 tools covering every aspect of your personal finances.

💳

### Transactions

Query and filter transactions by merchant, category, amount, date range, location, and more. Spot refunds, duplicates, and foreign charges.

📈

### Investments

Portfolio holdings, price history, stock splits, time-weighted returns, and per-security performance tracking.

🎯

### Budgets & Goals

Create and track budgets by category. Set savings goals with monthly progress snapshots.

🔁

### Recurring Charges

Identify subscriptions and recurring bills. See frequency, monthly cost, confidence scores, and next charge dates.

🏦

### Accounts & Balances

View all linked accounts with balances. Track daily, weekly, or monthly balance history over time.

🔒

### Privacy First

Reads are fully local — zero network requests from this server. No servers, no analytics, no data collection. Data you query is shared with your AI provider.

## Local-first, no project servers

Reads go straight to your locally cached Copilot Money database — zero network requests from this server. Nothing is ever sent to us. Note: the AI client you connect (Claude, Cursor, Codex CLI, etc.) is a third party and will see the finance data you query — check its privacy policy.

✓ Read-only
✓ No data collection
✓ No analytics or telemetry
✓ No project servers
✓ Open source
Requirements

## What you need

☕

### macOS

Copilot Money stores its local database on macOS. The MCP server reads this cached data.

💰

### Copilot Money App

Install Copilot Money from the Mac App Store. Sync your accounts so data is cached locally.

⚙

### Node.js 18+

Required to run the MCP server. Download Node.js. Claude Desktop includes it bundled.