Documentation

Money Copilot AI Docs

Connection guide, tool reference, and troubleshooting.

Money Copilot AI is a Model Context Protocol (MCP) server that lets your AI assistant — Claude, ChatGPT, or any MCP-compatible client — track expenses, manage budgets, and report on your finances through natural conversation. Each subscriber's data is isolated automatically; no bank account linking is required.

On this page

Connect your assistant

Claude

  1. In Claude, go to Settings → Connectors.
  2. Select Add custom connector (or find Money Copilot AI in the connector directory, once listed).
  3. Enter the server URL:
    https://expense-tracker-mcp.mcpize.run/mcp
  4. Approve the connection when Claude prompts you to sign in — this authenticates the assistant to your account without exposing your credentials to Claude.
  5. Start a new conversation and try one of the example prompts below.

ChatGPT

  1. In ChatGPT, open Settings → Connectors → Advanced and enable developer mode if prompted.
  2. Add a new connector using the same server URL:
    https://expense-tracker-mcp.mcpize.run/mcp
  3. Complete the sign-in prompt to link your account.
  4. Enable the connector for the conversation and start tracking.

Prefer a visual walkthrough? See the step-by-step guide on the home page.

What you can do

Once connected, just talk naturally — no forms, no menus. A few examples:

“Spent $12 on lunch today.” “How much did I spend this month?” “Show my restaurant expenses from last month.” “Which category did I spend the most on?” “Set my monthly food budget to $300.” “What unnecessary expenses can I reduce?” “Update yesterday's coffee expense to $5.” “Give me a full budget report for July.”

Tool reference

All tools operate only on your own authenticated account — the server never has access to another subscriber's data.

Read-only runs without confirmation Write creates or updates your data Destructive your assistant will always confirm first

Expenses

ToolWhat it does
add_expenseWriteRecord a single expense (amount, category, description, date, currency).
add_expensesWriteRecord several expenses in one call — efficient for a receipt with many line items.
list_expensesRead-onlyList expenses, newest first, with category / date-range / free-text search filters.
get_expense / get_recent_expenseRead-onlyFetch one expense by id, or resolve "my last expense" to a concrete record.
update_expenseWriteUpdate fields of an existing expense.
delete_expenseDestructiveDelete a single expense by id.
split_expenseWriteRecord one purchase split across two or more categories.
import_expensesWriteBulk-import expenses from CSV, with duplicate-row skipping.
export_expensesRead-onlyExport expenses as CSV, JSON, or a portable PDF report.
find_duplicate_expensesRead-onlyIdentify likely duplicate transactions.
summarize_expensesRead-onlyAggregate totals grouped by category or month.

Budgets & categories

ToolWhat it does
set_budgetWriteCreate or update a monthly budget (overall or per-category).
list_budgetsRead-onlyList all budgets you've set.
delete_budgetDestructiveRemove a budget (overall or per-category).
get_budget_statusRead-onlyCompare spending against your budgets, with over-budget flags.
get_budget_alertsRead-onlyCheck configured threshold alerts and over-budget categories.
set_alert_thresholdsWriteConfigure the 50/80/100%-style budget alert thresholds.
set_budget_email_alertWriteOpt into an email notification when a monthly budget is crossed.
list_categoriesRead-onlyList categories you've used, with counts and totals.
manage_categoriesDestructiveList, create, update, or remove custom category limits and colors.
manage_budget_templatesDestructiveSave, apply, list, or delete reusable budget templates.

Income, cash flow & reports

ToolWhat it does
add_incomeWriteRecord income for cash-flow and savings tracking.
get_cash_flow_reportRead-onlyIncome, expenses, net cash flow, and savings rate for a month.
get_spending_forecastRead-onlyForecast month-end spending from what you've spent so far.
compare_monthsRead-onlyCompare spending across recent months, with a trend chart.
full_budget_reportRead-onlyComplete monthly report: totals, category breakdown, and budget charts.
set_recurring_expenseWriteTrack recurring rent, subscriptions, utilities, or loan payments.

Account

ToolWhat it does
get_dashboard_linkRead-onlyCreate a short-lived link to your private web dashboard.
delete_accountDestructivePermanently delete every expense, budget, and finance record on your account. Irreversible — see our Privacy Policy for what's retained briefly for security purposes.

Data & formats

A few conventions your assistant (and the server) follow under the hood:

AmountsMajor units, e.g. 12.50 for $12.50. Never minor units (cents).
DatesYYYY-MM-DD. Omit it and today's date is used.
MonthsYYYY-MM for monthly reports and budgets.
Currency3-letter ISO-4217 code, e.g. USD, EUR, BDT. Defaults to your account's currency if omitted.

Privacy & data

Your financial data is private to your authenticated account and is never used to train third-party AI models. Read the full Privacy Policy for what's collected, how it's used, and how to request deletion.

Troubleshooting

My assistant isn't finding the connector

Double-check the server URL is exactly https://expense-tracker-mcp.mcpize.run/mcp (including the trailing /mcp), and that the connector is enabled for your current conversation — some clients require enabling tools per-chat even after connecting once.

It says "authentication required" or asks me to sign in again

Your session may have expired. Re-run the connection step in your assistant's connector settings and approve the sign-in prompt again — this doesn't affect any of your existing data.

Can I use more than one currency?

Yes. Each expense, budget, and income entry stores its own currency; reports total per-currency rather than incorrectly combining amounts across currencies.

How do I permanently delete my data?

Ask your assistant to delete your account, or use the data-management option in your dashboard. This is irreversible — see the Privacy Policy for exactly what's removed.

Is my data shared with other users, or used to train AI models?

No. Your data is isolated to your authenticated account and is never sold or used to train third-party AI models — see the Privacy Policy for details.

Need help?

Something not working as expected? Visit Customer Support or email support@contact.copilotai.live.