EN ID
โ† User Guide

Connect Your Own AI
(MCP)

Use Claude, ChatGPT, or Grok as a chat interface to your Finance Tracker data. Ask questions, pull reports, reconcile a statement, or record transactions, all in your own AI app.

Claude ChatGPT Grok
The one thing to remember: all you need is your Server URL. Paste it in, sign in with your Finance Tracker account, done. You do not paste an access token, Client ID, or Client Secret into Claude, ChatGPT, or Grok. Those apps sign you in for you.

Contents

  1. What is MCP?
  2. Get Your Server URL
  3. Set Up in Claude
  4. Set Up in ChatGPT
  5. Set Up in Grok
  6. Advanced: Command-Line Tools
  7. What You Can Ask
  8. Troubleshooting

What is MCP?

MCP (Model Context Protocol) is a standard way for AI apps to talk to your tools. Finance Tracker runs an MCP server, so any MCP-capable AI can read and update your finance data, with your permission.

๐Ÿ’ฌ

Your AI, your data

Instead of opening the web app, ask your AI: “What did we spend on groceries last month?” or “Record $40 fuel on the Amex.” The AI does the thinking; Finance Tracker does the bookkeeping.

๐Ÿ”’

Family-bounded & safe

Access is locked to your family’s data only. The AI can never see another family’s records. Every write is recorded as coming from you. You can revoke access any time from User Settings.

๐Ÿ‘๏ธ

Read-only mode (optional)

Prefer the AI to look but not touch? In User Settings โ†’ AI Access (MCP) tick Read only. The AI can still read and analyse every report, but it cannot log, undo, or change any transaction. Leave it unticked for full read & write. Default is off (full access).


Get Your Server URL

Every setup below starts with the same URL. Grab it once.

  1. 1Open the web app and click your username (top right) โ†’ User Settings.
  2. 2Scroll to AI Access (MCP).
  3. 3Copy the Server URL. It looks like this:
https://your-host/mcp
That’s the only value you need for Claude, ChatGPT, and Grok. Keep this tab open, you’ll paste the URL in the next steps.

Set Up in Claude

Works on claude.ai and the Claude desktop app. Uses a “custom connector.”

  1. 1In Claude, open Settings โ†’ Connectors and click Add custom connector.
  2. 2Name: type anything, e.g. Finance Tracker.
  3. 3Remote MCP server URL: paste your Server URL.
  4. 4Open Advanced settings and leave OAuth Client ID and OAuth Client Secret blank. They are optional. Finance Tracker registers Claude automatically.
  5. 5Click Add. A sign-in pop-up opens. Log in with your normal Finance Tracker account and click Approve.
  6. 6In any chat, open the tools/connectors menu and make sure Finance Tracker is enabled. Ask away.

What the form looks like

Claude ยท Add custom connector
Name
Finance Tracker
Remote MCP server URL
https://your-host/mcp
OAuth Client ID (optional)
leave blank
OAuth Client Secret (optional)
leave blank
Claude Code (terminal)? That’s a command-line tool, see Advanced.

Set Up in ChatGPT

ChatGPT hides custom MCP servers behind Developer mode, and custom connectors now live under Plugins. Turn Developer mode on first, then add Finance Tracker as a Plugin.

A. Turn on Developer mode

  1. 1Open Settings โ†’ Security & login.
  2. 2Scroll to Developer mode and switch it on. This unlocks custom MCP servers.
Developer mode for MCP is available on paid ChatGPT plans (Plus / Pro / Business). If you don’t see it, your plan may not include it yet.

B. Add the plugin

  1. 1Open Plugins (this is what ChatGPT used to call Connectors) and click + โ†’ New Plugin.
  2. 2Name: e.g. Finance Tracker. Description is optional.
  3. 3Connection: choose Server URL and paste your Server URL.
  4. 4Authentication: select OAuth. Leave the Advanced OAuth settings empty.
  5. 5Tick “I understand and want to continue”, then click Create.
  6. 6Finish the sign-in pop-up with your Finance Tracker account and approve.
  7. 7In a chat, enable the plugin (Developer mode / tools menu) and start asking.

What the form looks like

ChatGPT ยท New Plugin
Name
Finance Tracker
Connection: Server URL
https://your-host/mcp
Authentication
OAuth
โ˜‘ I understand and want to continue

Set Up in Grok

Grok keeps it simple: just a name and a URL.

  1. 1In Grok, open the Connectors / Custom Connector settings.
  2. 2Name: e.g. Finance Tracker.
  3. 3Server URL: paste your Server URL (use the https://your-host/mcp address, not the /sse example shown in the placeholder).
  4. 4Click Add Connector, then sign in with your Finance Tracker account when prompted.

What the form looks like

Grok ยท Custom Connector
Name
Finance Tracker
Server URL
https://your-host/mcp

Advanced: Command-Line Tools

Only for tools that connect with a token header instead of a sign-in pop-up: Claude Code, curl, custom scripts. Most people can skip this.

Generate an access token

  1. 1Go to User Settings โ†’ AI Access (MCP) โ†’ open Advanced โ†’ Generate Token.
  2. 2Copy it immediately, it’s shown once. It starts with ftmcp_. Treat it like a password.
Generating a new token revokes the previous one. Revoke All Access in Settings disconnects every client, command-line and signed-in apps alike.

Claude Code

claude mcp add finance-tracker https://your-host/mcp \
  --transport http \
  --header "Authorization: Bearer ftmcp_..."

Any client via mcp-remote

{
  "mcpServers": {
    "finance-tracker": {
      "command": "npx",
      "args": [
        "mcp-remote", "https://your-host/mcp",
        "--header", "Authorization: Bearer ftmcp_..."
      ]
    }
  }
}

Quick test with curl

curl -s https://your-host/mcp \
  -H "Authorization: Bearer ftmcp_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What You Can Ask

Once connected, talk to your AI in plain language. Each prompt maps to something you already do in the app, the AI just gets there faster.

Reading & analysing

Always available, even in Read only mode.

Say thisWhat it does
“Show our income statement for last month.”Same as opening Income Statement in Report.
“What’s our net worth right now, and how did it change since January?”Pulls the Balance Sheet for each period and compares them.
“How are we tracking against the budget this month?”Same as the Budget vs actual review in Report.
“List all Dining transactions this month and total them.”Same as filtering History by category, then summing.
“What are the balances on all our accounts?”Same as the Accounts / Balance view.
“How did my Etsy side-job do in June?”Same as opening that Side Job’s P/L report on the Report tab.
“What FX rate are you using for USD today?”Reads the tracker’s current (or a month’s historical) FX rates.
“Which recurring bills are due in the next two weeks?”Reads the family’s recurring rules and their next run dates.
“Where did most of our spending go last quarter?”Pulls several months of data and analyses it for you. There is no equivalent single screen.

Recording & changing

Needs write access, so it is disabled when Read only is ticked in User Settings.

Say thisWhat it does
“Record $85 groceries on the NAB card, dated yesterday.”Same as recording a transaction in the app.
“Here’s my credit-card statement, add any transactions we’re missing.”Reconciles the statement, then records the missing rows in one batch.
“Log my $1,200 salary into the CBA account for the 1st.”Records an income transaction.
“Move $500 from Savings to the offset account.”Records a transfer between two accounts.
“That last coffee was a mistake, undo it.”Same as undoing a transaction from History.
“Create a ‘Pet Care’ category with a paw icon.”Same as adding a category in the Manage tab.
“Add a new NAB offset account and set its opening balance to $3,000.”Same as adding an account and setting its initial balance in the Manage tab.
“Set up my $600/month grocery budget and $150 for dining.”Same as filling out the Budgeting Tool. The AI reads your current budget first, then fills or updates it.
“Add a recurring $45 gym membership charge on the 1st of every month.”Same as adding a recurring rule in the Manage tab.
“I buy the same $7 Subway sandwich on the Amex most days, make that a shortcut called sub.”Same as adding a Shortcut in the Manage tab. After that, typing sub anywhere records the whole transaction.
“Log my sub.”Records the transaction a shortcut stands for. Say the amount or the account only if it is different from the saved one.
“Set up an Etsy side job to track its own income and expenses.”Same as adding a Side Job in the Manage tab. The AI can also close or reopen one when it wraps up.
“Check my tracker and tell me what I’m missing: accounts, categories, budget, anything.”Runs a setup review: a checklist of missing accounts, opening balances, categories, budget, recurring rules and side jobs. Handy for first-time setup.
“Look through my transaction history and find anything that looks recurring.”Scans your ledger for repeating patterns and suggests recurring rules to add.
The AI always tells you what it’s about to record. Review before you confirm, same as the Telegram bot. Want reads only? Tick Read only in User Settings โ†’ AI Access (MCP) and the whole second table is switched off.

Troubleshooting

ProblemFix
The app asks for a Client ID / SecretLeave them blank. They’re optional, the sign-in pop-up handles everything.
No sign-in pop-up appearedCheck your browser’s pop-up blocker, then remove and re-add the connector.
“Unauthorized” after it worked beforeYour access was revoked, or your family membership changed. Reconnect (apps) or generate a new token (command-line).
ChatGPT has no “New Plugin” optionTurn on Developer mode first (Settings โ†’ Security & login). It’s on paid plans only.
The AI says it can’t record or undo anythingRead only is ticked in User Settings โ†’ AI Access (MCP). Untick it to allow writing.
Want to disconnect everythingUser Settings โ†’ AI Access (MCP) โ†’ Revoke All Access. Every client loses access instantly.