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

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!

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).

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.

Ask AI about your finances

Install in 2 minutes

Claude Desktop (one-click install)

OpenAI Codex CLI

Google Gemini CLI

Cursor

VS Code (built-in MCP, 1.102+)

Windsurf

Cline (VS Code Extension)

Any MCP Client (via npx)

What can you do?

Analyze your spending

Everything you need

Transactions

Investments

Budgets & Goals

Recurring Charges

Accounts & Balances

Privacy First

Local-first, no project servers

What you need

macOS

Copilot Money App

Node.js 18+