# copilot-money-mcp

> MCP server for Copilot Money App - AI powered personal finance queries using local data

- **URL**: https://www.freshcrate.ai/projects/copilot-money-mcp
- **Author**: ignaciohermosillacornejo
- **Category**: MCP Servers
- **Latest version**: `v2.2.0` (2026-05-13)
- **License**: MIT
- **Source**: https://github.com/ignaciohermosillacornejo/copilot-money-mcp
- **Language**: TypeScript
- **GitHub**: 32 stars, 13 forks
- **Registry**: github
- **Tags**: `bun`, `copilot-money`, `leveldb`, `mcp`, `personal-finance`, `typescript`

## Description

MCP server for Copilot Money App - AI powered personal finance queries using local data

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.2.0` | 2026-05-13 | High | This release closes Phases 1–3 of the `--live-reads` migration (GraphQL-backed reads layered over the local LevelDB cache, gated by `--live-reads` and a browser session). The live surface now covers transactions, accounts, categories, budgets, recurring charges, holdings, balances, investment prices, tags, net worth, monthly spend, and upcoming recurrings — 13 live read/utility tools that swap in for 6 cache-mode equivalents and add 7 new ones. Default mode (no flags) stays fully local and offl |
| `v2.1.0` | 2026-04-23 | High | ### Added  - **Four new transaction write tools** bringing the write surface to 17 (total: 17 read + 17 write = 34 tools). All mirror the shapes Copilot's own web app uses via GraphQL:   - **`create_transaction`** ([#320](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/pull/320)) — add a manual transaction to a non-Plaid account. Supports `internal_transfer` flag and amount bounds. The GraphQL response is mapped back to the project's Transaction shape and returned directly; `get_t |
| `v2.0.1` | 2026-04-16 | High | ### Added  - **Optimistic in-memory cache patching after writes.** Every successful GraphQL write now patches the corresponding entity in `CopilotDatabase`'s in-memory cache, so a subsequent read returns the new value without needing `refresh_database` + re-decode from LevelDB. Removes the stale-after-write UX for agents that write-then-read. - **Local-only `pack:mcpb:write` build script.** Produces a `copilot-money-mcp-write.mcpb` bundle advertising all 30 tools (17 read + 13 write) with `--wr |
| `v2.0.0` | 2026-04-15 | High | **Write tools are back** — rewritten onto Copilot Money's official GraphQL API (`https://app.copilot.money/api/graphql`) after direct Firestore writes were blocked by Copilot's server-side type-check deploy. Opt-in via `--write` (unchanged). 13 write tools (down from 18) across transactions, tags, categories, budgets, and recurrings.  **.mcpb bundle note:** The `.mcpb` attached to this release is intentionally **read-only** (17 read tools, `--write` not in `mcp_config.args`). Non-technical users |
| `v1.7.1` | 2026-04-15 | High | ### Fixed - **Extension now installs on current Claude Desktop** (#249, upstream [mcpb#229](https://github.com/modelcontextprotocol/mcpb/issues/229)): Claude Desktop 1.2581+ runs Node MCPB extensions inside an Electron UtilityProcess that enforces macOS hardened-runtime library validation, which rejects ad-hoc-signed npm prebuilds (our `classic-level` binding). The process died in `dlopen` before any of our code ran, leaving users with a silent "Server disconnected" status. Routes the launch th |
| `v1.7.0` | 2026-04-14 | High | ### Changed - **Published CLI is now read-only.** Copilot Money has restricted direct Firestore writes from third-party clients (403 `PERMISSION_DENIED`), so the 18 write tools can no longer succeed against the live backend. The `copilot-money-mcp` CLI shipped via npm and the `.mcpb` bundle now advertises only the 17 read tools; passing `--write` prints a notice and still starts read-only. Write tool source (`src/tools/`, `FirestoreClient`, auth) is preserved on `main` for a future GraphQL-base |
| `v1.6.1` | 2026-04-13 | High | ### Fixed - **`create_category` writes app-compatible documents** (#232): MCP-created categories were invisible to the Copilot Money app because they were missing required fields (`id`, `emoji`, `color`, `bg_color`, `order`, `is_other`, `auto_budget_lock`, `auto_delete_lock`, `plaid_category_ids`, `partial_name_rules`) and used a `custom_*` ID format the app doesn't recognize. Now uses Firestore auto-generated IDs and writes all app-required fields with sensible defaults. - **`get_categories` u |
| `v1.6.0` | 2026-04-12 | Medium | ## What's Changed * Update total balance calculation in getAccounts: subtract debt from assets by @martco in https://github.com/ignaciohermosillacornejo/copilot-money-mcp/pull/151 * feat: add total_assets and total_liabilities to getAccounts by @ignaciohermosillacornejo in https://github.com/ignaciohermosillacornejo/copilot-money-mcp/pull/155 * chore(ci): bump 1password/load-secrets-action from 3 to 4 by @dependabot[bot] in https://github.com/ignaciohermosillacornejo/copilot-money-mcp/pull/152 * |
| `v1.5.0` | 2026-04-06 | High | ## Added - **`get_holdings` tool**: Current investment positions with ticker, name, quantity, price, average cost, and total return per holding - **`get_investment_prices` tool**: Historical price data (daily + high-frequency) for stocks, ETFs, mutual funds, and crypto - **`get_investment_splits` tool**: Stock split history with ratios, dates, and multipliers - Database accessors for securities and holdings history collections - Full decode coverage for all 35 Firestore collection paths (securit |
| `v1.4.0` | 2026-04-06 | Medium | ## Fixed - **Decode timeout**: Made decode timeout configurable via `--timeout` CLI flag, with a sensible default of 90 seconds - Threaded timeout config through the stack instead of using environment variables - Prevented promise hang when decode worker exits without sending a result  ## Changed - CI: Skip AI code review on Dependabot and forked PRs  ## What's Changed * ci: skip AI code review on forked PRs by @ignaciohermosillacornejo in https://github.com/ignaciohermosillacornejo/copilot-mone |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 16
- **Resolved**: 16
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-06-08

## Citation

- HTML: https://www.freshcrate.ai/projects/copilot-money-mcp
- Markdown: https://www.freshcrate.ai/projects/copilot-money-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/copilot-money-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._