AI Assistant Integrations

Connect matcha money to your favorite AI assistant for natural language access to your financial data.

Claude (Anthropic)

Claude.ai (Web)

matcha money supports MCP (Model Context Protocol) for Claude.ai integration.

Open Claude.ai
Go to Settings > Integrations > Add Remote MCP Server
Enter URL: https://matcha.money
Click Connect - you'll be redirected to sign in
Authorize access to your matcha money account

Claude will auto-discover the MCP configuration and available tools.

Claude Desktop

Add matcha money to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "matcha-money": {
      "url": "https://matcha.money/api/mcp/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get your API key from: Settings > API Keys in matcha money.

Claude Code (CLI)

Add to your MCP settings (typically in ~/.config/claude-code/settings.json):

{
  "mcpServers": {
    "matcha-money": {
      "url": "https://matcha.money/api/mcp/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ChatGPT (OpenAI)

Using Custom GPTs with Actions

ChatGPT can access matcha money via Custom GPTs with Actions.

Creating Your Own Custom GPT

Go to ChatGPT > My GPTs > Create a GPT
Go to the Configure tab
Click Actions > Create new action
Click Import from URL and enter: https://matcha.money/openapi.yaml
Configure OAuth authentication:
- Authentication Type: OAuth
- Client ID: (from your matcha money admin)
- Client Secret: (from your matcha money admin)
- Authorization URL: https://matcha.money/api/auth/oauth2/authorize
- Token URL: https://matcha.money/api/auth/oauth2/token
- Scope: openid profile email api:access
- Token Exchange Method: POST request
Save and test your GPT

Suggested System Prompt

You are a helpful financial assistant with access to the user's matcha money account. You can:

- View accounts, balances, and balance history
- Search and filter transactions by merchant, amount, date, category, or account
- Check budget targets, spending progress, and income
- Monitor savings goals and recurring bills
- Track net worth and investment holdings over time
- View credit card and loan details (APR, minimum payments, debt summary)
- Manage categories, tags, and auto-categorization rules
- View and match itemized receipts to transactions

Always format monetary amounts clearly with currency symbols. Be concise and helpful with financial insights.

Available MCP Tools

Your AI assistant gets access to the following tools. Read tools are available on all tiers; write tools require Estate (Pro).

Transactions

Tool	Description
`get_transactions`	Search and filter transactions by date, amount, merchant, category, account, and more. Supports incremental sync.
`manage_transactions`	Create, update, delete, split, or batch update transactions.

Budget

Tool	Description
`get_budget`	Get budget targets, spending analysis, or income data.
`manage_budgets`	Set budget targets or transfer funds between categories and goals.
`get_goals`	Get savings goals and progress.
`manage_goals`	Create, update, archive, or unarchive savings goals.
`get_recurring_bills`	Get all recurring bills.
`manage_recurring_bills`	Create, update, or delete recurring bills.

Portfolio

Tool	Description
`get_accounts`	List all financial accounts (bank, credit card, investment).
`get_account`	Get detailed account info with optional balance history.
`manage_accounts`	Batch create/update manual accounts, reconcile balances, archive/unarchive.
`get_net_worth`	Get current net worth or historical trend.
`get_holdings`	Get investment holdings by account or aggregated by ticker.
`get_liabilities`	Get credit cards and loans with APR, minimum payments, and debt summary.
`manage_holdings`	Batch create/update/delete investment holdings.
`manage_manual_items`	Create, update, delete, or list manual banks for organizing manual accounts.

Categories, Tags & Rules

Tool	Description
`get_taxonomy`	Get all categories and tags.
`manage_taxonomy`	Create, update, or delete categories and tags.
`merge_tags`	Merge one tag into another (irreversible).
`get_rules`	Get all auto-categorization rules.
`manage_rules`	Create, update, or delete categorization rules.
`run_rules`	Run rules on all uncategorized transactions.

Receipts

Tool	Description
`get_receipts`	Get receipts with optional status filter (unmatched, matched, dismissed).
`manage_receipts`	Match receipts to transactions, dismiss, or batch add from the browser extension.
`get_merchant_ids`	Look up merchant IDs from the merchant registry for batch receipt imports.

Subscription Tiers & Access

Tier	AI Access
Leaf (Free)	Read-only access to all data
Estate (Pro)	Full read/write access
Preserve	AI access disabled for privacy

Troubleshooting

OAuth connection fails

Ensure you're signed into matcha money in your browser
Check that third-party cookies are enabled
Try signing out of matcha money and signing back in
Clear your browser cache and try again

API key not working

Verify the key is active in Settings > API Keys
Check the key hasn't expired
Ensure your account has the correct subscription tier
Try generating a new API key

Claude can't find tools

Verify the MCP endpoint is reachable: https://matcha.money/api/mcp
Check your API key has the api:access scope
Restart Claude Desktop after config changes

ChatGPT Action errors

Re-import the OpenAPI spec to get the latest schema
Verify your OAuth credentials are correct
Check the callback URL is properly configured

Developer Resources

OpenAPI Spec: https://matcha.money/openapi.yaml
MCP Discovery: https://matcha.money/.well-known/mcp-configuration
API Documentation: See API Docs

Privacy & Security

All connections use HTTPS encryption
OAuth tokens expire and can be revoked
API keys can be rotated at any time
The Preserve tier blocks all AI access for maximum privacy
matcha money never shares your financial data with AI providers beyond what you explicitly authorize