Skip to content
Back to search

copilot-money-mcp

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ignaciohermosillacornejo/copilot-money-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ignaciohermosillacornejo/copilot-money-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ignaciohermosillacornejo--copilot-money-mcp/badge.svg)](/listings/ignaciohermosillacornejo--copilot-money-mcp)

HTML

<a href="/listings/ignaciohermosillacornejo--copilot-money-mcp"><img src="/api/listings/ignaciohermosillacornejo--copilot-money-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- **Node.js 18+** (comes bundled with Claude Desktop) - **Copilot Money** (macOS App Store version) - **Claude Desktop**, **Cursor**, or any MCP-compatible client - **For `--live-reads` or `--write` only:** a supported browser logged in to [app.copilot.money](https://app.copilot.money) — the Chromium family, Firefox, or Safari; see [docs/graphql-live-reads.md](docs/graphql-live-reads.md) for the list. The server reuses that session's Firebase refresh token. Without it the server still starts, and the first live or write tool call tells the assistant to log in — log in and retry, no restart needed. Default mode needs nothing — it reads the local cache and makes no network requests.

Installation via Claude Desktop

1. Download the latest `.mcpb` bundle from [Releases](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/releases) 2. Double-click the `.mcpb` file to install in Claude Desktop 3. Restart Claude Desktop 4. Start asking questions about your finances!

Installation via npm

npm install -g copilot-money-mcp

Then add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Installation for Cursor

1. Install the package globally:

   npm install -g copilot-money-mcp

2. Open Cursor Settings (`Cmd + ,`) > **Features > MCP Servers**

3. Add the server configuration:

   {
     "mcpServers": {
       "copilot-money": {
         "command": "copilot-money-mcp"
       }
     }
   }

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 388 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Copilot Money MCP Server
  2. > Query and manage your personal finances with AI using local Copilot Money data
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![Node.js 18+](https://img.shields.io/badge/node-18+-green.svg)](https://nodejs.org/)
  5. [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue.svg)](https://www.typescriptlang.org/)
  6. [![Tests](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/actions/workflows/test.yml)
  7. [![codecov](https://codecov.io/gh/ignaciohermosillacornejo/copilot-money-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/ignaciohermosillacornejo/copilot-money-mcp)
  8. [![copilot-money-mcp MCP server](https://glama.ai/mcp/servers/ignaciohermosillacornejo/copilot-money-mcp/badges/score.svg)](https://glama.ai/mcp/servers/ignaciohermosillacornejo/copilot-money-mcp)
  9. [![MCP Registry](https://img.shields.io/badge/MCP_Registry-copilot--money--mcp-blue)](https://registry.modelcontextprotocol.io/?q=copilot-money-mcp)
  10. ## Disclaimer
  11. **This is an independent, community-driven project and is not affiliated with, endorsed by, or associated with Copilot Money or its parent company in any way.** This tool was created by an independent developer to enable AI-powered queries of locally cached data. "Copilot Money" is a trademark of its respective owner.
  12. > [!NOTE]
  13. > **Copilot Money now has an official MCP server.** It is read-only, with write support announced as coming later, and connects to MCP clients over OAuth. If a first-party, read-only integration suits your needs, you should strongly consider using it instead of this community project. Setup instructions: [Setting up the MCP](https://help.copilot.money/en/articles/14758080-setting-up-the-mcp).
  14. >
  15. > This project remains useful if you need write tools today (categorize transactions, manage budgets, edit recurrings, etc.) or fully offline cache-mode reads with zero network requests.
  16. ## Overview
  17. An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants access to your Copilot Money personal finance data. It reads from the locally cached Firestore database (LevelDB + Protocol Buffers) on your Mac. **Reads are 100% local with zero network requests.**
  18. **14 cache-mode read tools (or 25 in `--live-reads` mode: 8 surviving cache + 17 live), plus up to 19 write tools** — query and modify transactions, accounts, holdings, balances, categories, recurring charges, budgets, goals, and investment performance. See [Tools by Mode](#tools-by-mode) below.
  19. > Contributors: writes go through an API we don't own. How the repo keeps its model of Copilot's GraphQL surface from silently drifting — the conformance ledger, live smokes, and weekly drift check — is documented in [`docs/CONFORMANCE_ARCHITECTURE.md`](docs/CONFORMANCE_ARCHITECTURE.md).
  20. ## Privacy First
  21. We never collect, store, or transmit your data to any server operated by this project — we don't have any. See our [Privacy Policy](PRIVACY.md) for details.
  22. - No analytics, telemetry, or tracking of any kind
  23. - Reads are fully local — zero network requests
  24. - Open source — verify the code yourself
  25. > [!IMPORTANT]
  26. > **Heads up about AI providers.** While this server itself runs locally and never sends your data to any server operated by this project, **the AI assistant you connect it to (Claude, ChatGPT, Gemini, etc.) will see your Copilot Money data** as part of answering your questions. That means your financial data will be transmitted to and processed by the provider of whichever model you choose — **Anthropic, OpenAI, Google, or another third party** — subject to that provider's own privacy policy and data retention terms.
  27. >
  28. > **By using this MCP server with a hosted AI model, you are knowingly sharing your financial data with that AI provider.** Only use this tool if you are comfortable with that trade-off. If you are not, consider using a fully local model.
  29. ## Tools by Mode
  30. This server exposes different tools depending on which CLI flags you enable.
  31. | Mode | Flag | What it does | Auth | Network | Tools available |
  32. |---|---|---|---|---|---|
  33. | 🟢 Default | _(none)_ | Reads from your local LevelDB cache | ❌ None | 🔌 Zero (offline) | 14 cache-mode read + utility tools |
  34. | 🌐 Live reads | `--live-reads` | Real-time reads via Copilot's GraphQL API; swaps out 6 cache tools and adds 11 live-only ones | 🔒 Browser session | 🌐 HTTPS per request | 25 read tools (8 cache + 17 live) |
  35. | ✍️ Writes | `--write` | Adds mutation tools (transactions, tags, categories, budgets, recurrings, splits) **and turns on `--live-reads` automatically** — writes need server-fresh transaction metadata, so live reads are coupled to write mode | 🔒 Browser session | 🌐 HTTPS per request | +19 write tools, on top of the 25 live read tools |
  36. Passing `--write` implies `--live-reads`; you can still pass `--live-reads` on its own for read-only live access.
  37. 📖 **See [docs/tools-by-mode.md](docs/tools-by-mode.md)** for the full per-tool inventory with status, caveats, and known limitations (goals, stock splits, response-size caps).
  38. ⬆️ **Upgrading from v2?** v3.0.0 changed the shape of read responses — see **[docs/MIGRATING-v3.md](docs/MIGRATING-v3.md)**. No tool was renamed or removed; rows got terse and two arguments were retired.
  39. ---
  40. ## Quick Start
  41. ### Prerequisites
  42. - **Node.js 18+** (comes bundled with Claude Desktop)
  43. - **Copilot Money** (macOS App Store version)
  44. - **Claude Desktop**, **Cursor**, or any MCP-compatible client
  45. - **For `--live-reads` or `--write` only:** a supported browser logged in to
  46. [app.copilot.money](https://app.copilot.money) — the Chromium family, Firefox, or
  47. Safari; see [docs/graphql-live-reads.md](docs/graphql-live-reads.md) for the list.
  48. The server reuses that session's Firebase refresh token. Without it the server still
  49. starts, and the first live or write tool call tells the assistant to log in — log in
  50. and retry, no restart needed. Default mode needs nothing — it reads the local cache
  51. and makes no network requests.
  52. ### Installation via Claude Desktop
  53. 1. Download the latest `.mcpb` bundle from [Releases](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/releases)
  54. 2. Double-click the `.mcpb` file to install in Claude Desktop
  55. 3. Restart Claude Desktop
  56. 4. Start asking questions about your finances!
  57. ### Installation via npm
  58. ```bash
  59. npm install -g copilot-money-mcp
  60. ```
  61. Then add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
  62. ```json
  63. {
  64. "mcpServers": {
  65. "copilot-money": {
  66. "command": "copilot-money-mcp"
  67. }
  68. }
  69. }
  70. ```
  71. ### Installation for Cursor
  72. 1. Install the package globally:
  73. ```bash
  74. npm install -g copilot-money-mcp
  75. ```
  76. 2. Open Cursor Settings (`Cmd + ,`) > **Features > MCP Servers**
  77. 3. Add the server configuration:
  78. ```json
  79. {
  80. "mcpServers": {
  81. "copilot-money": {
  82. "command": "copilot-money-mcp"
  83. }
  84. }
  85. }
  86. ```
  87. ## What You Can Do
  88. ### Spending Analysis
  89. > "How much did I spend on dining out last month?"
  90. > "Show me all my Amazon purchases in the last 30 days"
  91. > "What are my top 5 spending categories this year?"
  92. Uses `get_transactions` (or `get_transactions_live` for fresh data via `--live-reads`) and `get_categories` (or `get_categories_live`), with date ranges, text search, and category filters.
  93. ### Account Overview
  94. > "What's my net worth across all accounts?"
  95. > "Show me my checking account balance over the past 6 months, monthly"
  96. > "Which bank connections need attention?"
  97. Uses `get_accounts` (or `get_accounts_live` for fresh balances via `--live-reads`), `get_balance_history` (with optional `get_balance_history_live` per-account live variant), `get_connection_status`, and `get_networth_live` for net-worth-over-time charts.
  98. ### Investment Portfolio
  99. > "What are my current holdings and total returns?"
  100. > "Show me the price history for my largest equity holding over the past year"
  101. > "What's my current cost basis on META?"
  102. Uses `get_holdings` (or `get_holdings_live` for live cost basis), `get_investment_prices` (or `get_investment_prices_live` for live per-security price history).
  103. ### Budgets & Goals
  104. > "Am I on track with my budgets this month?"
  105. > "How is my emergency fund progressing?"
  106. > "Show me my goal history over the past 6 months"
  107. Uses `get_budgets` (or `get_budgets_live` via `--live-reads`), and `get_goals` / `get_goal_history` (cache-only — Copilot's GraphQL endpoint doesn't expose goal data).
  108. ### Subscriptions & Recurring
  109. > "What subscriptions am I paying for?"
  110. > "How much do I spend on recurring charges per month?"
  111. Uses `get_recurring_transactions` (or `get_recurring_live` via `--live-reads`) and `get_upcoming_recurrings_live` for next-due unpaid items.
  112. ## Configuration
  113. ### Cache TTL
  114. The server caches data in memory for 5 minutes. Configure via environment variable:
  115. ```bash
  116. # Set cache TTL to 10 minutes
  117. COPILOT_CACHE_TTL_MINUTES=10 copilot-money-mcp
  118. # Disable caching (always reload from disk)
  119. COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp
  120. # Write tools resolve account/item ids for a transaction id via a live
  121. # window fetch when the in-memory index (fed by live reads) misses.
  122. # Default window: 13 months. Raise it to edit older transactions:
  123. COPILOT_WRITE_RESOLVE_WINDOW_MONTHS=30 copilot-money-mcp --write
  124. # Write-resolution routing ids (opaque transaction/account/item ids only —
  125. # never amounts or names) persist whenever live reads are enabled (including
  126. # --write mode), keyed by the logged-in account, so cross-session writes
  127. # skip the live window fetch.
  128. # The same switch also disables the persisted split-parent record
  129. # (split-parents.<uid>.jsonl, opaque ids only): delete_transaction then
  130. # remembers a parent split through this server only until it restarts, and
  131. # after a restart relies on the local cache to refuse it (#842).
  132. # Disable both entirely:
  133. COPILOT_DISABLE_PERSISTENT_INDEX=1 copilot-money-mcp --write
  134. ```
  135. You can also refresh manually using the `refresh_database` tool.
  136. ### Decode Timeout
  137. For large databases (500MB+), increase the decode timeout (default: 90 seconds):
  138. ```bash
  139. # Via environment variable
  140. DECODE_TIMEOUT_MS=600000 copilot-money-mcp
  141. # Via CLI flag
  142. copilot-money-mcp --timeout 600000
  143. ```
  144. For databases over 1GB, also increase Node.js memory:
  145. ```json
  146. {
  147. "mcpServers": {
  148. "copilot-money": {
  149. "command": "node",
  150. "args": [
  151. "--max-old-space-size=4096",
  152. "/path/to/copilot-money-mcp/dist/cli.js",
  153. "--timeout", "600000"
  154. ]
  155. }
  156. }
  157. }
  158. ```
  159. ### Supported Date Periods
  160. The `period` parameter supports these shortcuts:
  161. `this_month` `last_month` `last_7_days` `last_30_days` `last_90_days` `ytd` `this_year` `last_year`
  162. ## Authentication & Optional Modes
  163. Both `--live-reads` and `--write` make authenticated calls to Copilot Money's GraphQL API at `app.copilot.money/api/graphql`. They require a **logged-in browser session** against `app.copilot.money` — the server reads the same Firebase refresh token the web app stores in your browser. Ten browsers are searched — Chrome, Arc, Microsoft Edge, Brave, Vivaldi, Chromium, Opera, Opera GX, Safari, and Firefox — and each Chromium-family browser across every one of its profiles, not just the default one. See [PRIVACY.md](PRIVACY.md) for exactly which files are read and why the browser-wide `Local Storage` read is not scoped to Copilot's origin.
  164. On **Linux** the Linux locations are searched instead: Chrome (`~/.config/google-chrome`, plus `-beta` / `-unstable`), Microsoft Edge (`~/.config/microsoft-edge`), Brave (`~/.config/BraveSoftware/Brave-Browser`), Vivaldi (`~/.config/vivaldi`), Chromium (`~/.config/chromium` and the snap's `~/snap/chromium/common/chromium`), Opera (`~/.config/opera`), and Firefox (`~/.mozilla/firefox`, `~/.config/mozilla/firefox` where Firefox 147+ creates new profiles when there is no `~/.mozilla`, the snap's `~/snap/firefox/common/.mozilla/firefox`, and the flatpak's `~/.var/app/org.mozilla.firefox/.mozilla/firefox`). The `~/.config` locations honour `XDG_CONFIG_HOME`. Arc, Safari and Opera GX are macOS-only.
  165. #### Choosing the browser and profile: `--browser` / `--browser-profile`
  166. By default the browsers above are tried in that fixed order and the first working session wins. If more than one Copilot account is logged in on the machine — say one person in Brave and another in Chrome — pin the one to use:
  167. | Flag | Environment variable | Value |
  168. | --- | --- | --- |
  169. | `--browser <name>` | `COPILOT_BROWSER` | `chrome`, `arc`, `edge` (or `microsoft-edge`), `brave`, `vivaldi`, `chromium`, `opera`, `opera-gx` (or `operagx`), `safari`, `firefox` — case-insensitive |
  170. | `--browser-profile <name>` | `COPILOT_BROWSER_PROFILE` | Chromium family: the profile directory (`Default`, `Profile 2`) or the profile's display name as shown in the browser. Firefox: the profile directory (`abcd1234.default-release`), the part after its first dot (`default-release`), or its `Name=` in `profiles.ini`. Case-insensitive. A name that matches more than one profile is refused (see below). Prefix `dir:` to match only the exact, case-sensitive directory name (`dir:Profile 1`), or `name:` to match only display names / `Name=` (a name that itself starts with `dir:` or `name:` takes the prefix twice, e.g. `name:name:Work`). On Linux a Chrome profile name matches in each of the stable, beta and unstable channels, and every match is searched. Requires a browser. |
  171. | `--browser-data-dir <path>` | `COPILOT_BROWSER_DATA_DIR` | A custom user-data root that **replaces** the browser's default locations — for a browser launched with `--user-data-dir`, a portable install, or a copied profile. Chromium family: the folder holding `Local State` and the `Default` / `Profile N` dirs (Opera: also its root-layout storage). Firefox: a profiles root (holding `profiles.ini` and/or the profile dirs, directly or under `Profiles/`), or a single profile directory (one holding `storage/default`, `prefs.js` or `times.json`). Use an **absolute path**: a leading `~` is expanded and a relative path resolves against the server's working directory, which MCP hosts often set to `/`. Requires a browser; not supported for Safari. |
  172. Each flag wins over its environment variable. With a browser selected, **only that browser** (and, with a profile, only that profile) is read — there is no fallback to the others, so the session can never silently come from someone else's browser. If nothing is found, the error names exactly what was searched, e.g. `No Copilot Money session found in Brave (profile "Default"). …`, and says so when the browser's data directory or the profile does not exist.
  173. A profile name must pick **exactly one** profile. Display names are not unique, and Microsoft Edge's built-in ones are off by one from its directories (directory `Default` is shown as "Profile 1", directory `Profile 1` as "Profile 2"), so a name that matches one profile's directory and another's display name — or two display names, or two Firefox profiles — is refused, and nothing is searched: `--browser-profile "Profile 1" is ambiguous in Microsoft Edge: it matches directory "Profile 1" and the display name of directory "Default". Pick exactly one with --browser-profile "dir:Default" or "dir:Profile 1".` Every value the refusal offers selects exactly one profile: a Firefox profile that `profiles.ini` keeps outside the profiles directory is offered as `name:` instead, since `dir:` only sees listed directories, and two Firefox profiles that no name tells apart (the same directory name directly in a `--browser-data-dir` and under its `Profiles/`, or two `profiles.ini` entries with one `Name=` kept outside the profiles directory) are named by path: select one by dropping `--browser-profile` and pointing `--browser-data-dir` at it. The `dir:` form always names exactly one profile, so on a stock Edge with three or more profiles — where every middle `Profile N` is both a directory and another profile's display name — every profile stays selectable. A directory whose own display name is the same string is not ambiguous. On Linux, an ambiguity inside any one Chrome channel refuses the whole selection, and the message names that channel's directory.
  174. The selection only applies with `--live-reads` or `--write`. There, an unknown browser name, a profile without a browser, a macOS-only browser on Linux, or a bad `--browser-data-dir` stops the server at startup with an error. In the default cache-only mode no browser is read, so a selection — from flags or from the environment, valid or not — is ignored with a one-line warning on stderr instead of stopping the server.
  175. With `--browser-data-dir`, only that directory is read — not the browser's default locations and not any other browser. `--browser-profile` then matches profiles inside it (directory name, `Local State` display name, Firefox suffix or `profiles.ini` `Name=`, with relative `Path=` entries resolved against the data dir). Pointed at a single Firefox profile, no `--browser-profile` is needed, and one that names a different profile is refused. The server refuses to start if the path does not exist or is not a directory, if no browser is given, or if the browser is Safari (whose locations are fixed by macOS). If the directory holds no session, the error names it: `No Copilot Money session found in Chrome (data dir "/home/me/chrome-profile/Fork-18"). …`, and if the path looks like one Chromium profile (it is named `Default` / `Profile N` or holds a `Preferences` file) rather than the user-data root above it, the error says so and suggests the parent plus `--browser-profile`.
  176. ```json
  177. {
  178. "mcpServers": {
  179. "copilot-money": {
  180. "command": "copilot-money-mcp",
  181. "args": ["--live-reads", "--browser", "brave", "--browser-profile", "Default"]
  182. }
  183. }
  184. }
  185. ```
  186. Or, equivalently, `"env": { "COPILOT_BROWSER": "brave", "COPILOT_BROWSER_PROFILE": "Default" }` in the same entry. For a Chrome started with a custom `--user-data-dir`:
  187. ```json
  188. "args": ["--live-reads", "--browser", "chrome", "--browser-data-dir", "/home/me/chrome-profile/Fork-18"]
  189. ```
  190. Every flag that takes a value also accepts the `--flag=value` form (`--browser=chrome`), and an on/off flag such as `--write` or `--live-reads` also accepts `=true` / `=false`. A value-taking flag given without a value, or an unknown `--flag=value`, stops the server at startup instead of being ignored.
  191. Default mode requires no authentication and makes zero network requests — reads come from the local LevelDB cache.
  192. ### `--live-reads`: real-time reads via GraphQL
  193. ```bash
  194. copilot-money-mcp --live-reads
  195. ```
  196. Replaces 6 cache-mode read tools (`get_transactions`, `get_accounts`, `get_categories`, `get_budgets`, `get_recurring_transactions`, `get_holdings`) with live GraphQL-backed equivalents, and adds 11 net-new ones (`get_tags_live`, `get_networth_live`, `get_upcoming_recurrings_live`, `get_monthly_spend_live`, `get_balance_history_live`, `get_investment_prices_live`, `refresh_cache`, `get_investment_allocation_live`, `get_top_movers_live`, `get_aggregated_holdings_live`, `get_investment_balance_live`).
  197. Use this when:
  198. - You need transactions the macOS app hasn't pre-fetched yet (the auto-fetch window is typically ~30 days; past that, open the app and scroll back to force the cache to populate, or use `--live-reads` to query the server directly).
  199. - You want fresh per-security cost basis or balance-over-time data.
  200. - The macOS app hasn't synced recently.
  201. ### `--write`: mutations via GraphQL (implies `--live-reads`)
  202. ```bash
  203. copilot-money-mcp --write
  204. ```
  205. Adds 19 mutation tools for transactions, tags, categories, recurrings, budgets, and split-transactions. Off by default — the server is read-only unless you opt in.
  206. `--write` automatically enables `--live-reads` as well. Write tools resolve transaction metadata (account/item IDs) against the live GraphQL surface so they can edit any transaction the API exposes, not just the ~30 days the local LevelDB cache happens to hold. Once you've consented to the authenticated network calls writes require, there's no privacy or perf reason to keep reads pinned to the stale cache.
  207. ```bash
  208. copilot-money-mcp --write --live-reads # equivalent to `--write` alone; --live-reads is redundant
  209. ```
  210. ### Configuring via Claude Desktop / Cursor
  211. Add the flags to the `args` array in your MCP config:
  212. ```json
  213. {
  214. "mcpServers": {
  215. "copilot-money": {
  216. "command": "copilot-money-mcp",
  217. "args": ["--write"]
  218. }
  219. }
  220. }
  221. ```
  222. Restart Claude Desktop / Cursor after editing.
  223. ## Known Limitations
  224. ### Local Cache Dependency
  225. This server reads from Copilot Money's **local Firestore cache**, not the cloud. Firestore's offline persistence caches every document the app has ever fetched, so the local database generally contains all transactions, accounts, budgets, goals, and other data you've viewed in the app. The default Firestore cache size is 100 MB (enough for tens of thousands of transactions), and older documents are only evicted via LRU garbage collection if that limit is exceeded.
  226. **To maximize cached data:** Open the Copilot Money app and browse through your data (transaction history, accounts, budgets) to ensure it has been fetched and cached locally.
  227. ### Goals are read-only
  228. `get_goals` and `get_goal_history` work (cache-only), but there are no goal write tools — Copilot's GraphQL endpoint doesn't expose goal mutations. Goal creation, editing, and contributions are mobile-only in Copilot itself, and live in a path our project can't reach without iOS / desktop traffic capture.
  229. ### Investment splits are limited to currently-held securities
  230. `get_investment_splits` returns split events (date + adjustment multiplier) for securities you currently hold. Securities you no longer hold eventually fall out of the cache. There's no GraphQL endpoint for splits, so this is the only path.
  231. Also: `get_investment_prices` and `get_investment_prices_live` already return split- and dividend-adjusted prices (Copilot applies Plaid's adjustment factors server-side). You generally don't need raw split events to back-correct prices.
  232. ### Live investment prices are ownership-gated
  233. `get_investment_prices_live` only works for securities currently in your linked accounts. Asking for a price series on a ticker you don't own returns an explicit "not in your linked accounts" error.
  234. ### Long time-series responses are capped
  235. Time-series live tools (`get_balance_history_live`, `get_networth_live`, `get_investment_prices_live`) cap responses at 500 rows by default to fit the MCP single-tool-result token limit. Pass `max_rows` / `offset` to paginate, or narrow `time_frame` for fewer rows.
  236. `get_investment_balance_live` has its own, much tighter cap under a different name: `history_limit`, default **30** points, `0` for the whole series. Its responses always report `history_total_count` and `history_truncated`, and its `current` value is resolved separately so it can never be lost to truncation.
  237. ## Troubleshooting
  238. ### Database Not Found
  239. If you see "Database not available":
  240. 1. Ensure Copilot Money is installed and has synced data
  241. 2. Check the database location: `~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/__FIRAPP_DEFAULT/copilot-production-22904/main`
  242. 3. Verify `.ldb` files exist in the directory
  243. 4. Provide a custom path: `copilot-money-mcp --db-path /path/to/database`
  244. ### Decode Worker Timed Out
  245. If you see "Decode worker timed out":
  246. 1. Increase the timeout: `copilot-money-mcp --timeout 300000` (5 minutes)
  247. 2. For 1GB+ databases, also increase Node.js memory: `node --max-old-space-size=4096 dist/cli.js --timeout 300000`
  248. ### No Transactions Found
  249. - Open the Copilot Money app and wait for sync
  250. - The database structure may have changed — [open an issue](https://github.com/ignaciohermosillacornejo/copilot-money-mcp/issues)
  251. ## Contributing
  252. See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, architecture, and how to add new tools.
  253. ## License
  254. MIT License - See [LICENSE](LICENSE) for details.
  255. ## Acknowledgments
  256. - Built with [MCP SDK](https://modelcontextprotocol.io/) by Anthropic
  257. - Data validation with [Zod](https://zod.dev/)
  258. - Developed with [Bun](https://bun.sh/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.