1. Conduid
  2. Search
  3. partymola/monzo-mcp
MCP server · Search

partymola/monzo-mcp

· github.com/partymola/monzo-mcp

text search, and spending analysis with category breakdowns.

Unclaimed claudemcpmcp-servermodel-context-protocolmonzomonzo-apioauthpersonal-finance
InstallView source
34Low

Scored 5 months ago · breakdown

About partymola/monzo-mcp

partymola/monzo-mcp is an MCP server in the Search category: text search, and spending analysis with category breakdowns.

Install

From source
git clone https://github.com/partymola/monzo-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

monzo_get_balanceCurrent balance and spend today

Parameters not published.

monzo_list_accountsList accounts with types and IDs

Parameters not published.

monzo_list_potsSavings pots and balances

Parameters not published.

monzo_list_transactionsList/filter cached transactions

Parameters not published.

monzo_search_transactionsSearch by merchant/payee/description/notes

Parameters not published.

monzo_spendingSpending analysis with category breakdown

Parameters not published.

monzo_syncSync transactions to local cache

Parameters not published.

Ask AI

✦

Ask AI about partymola/monzo-mcp

Powered by Claude · Grounded in docs

I know everything about partymola/monzo-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

monzo-mcp

CI Glama MCP Server

MCP server for the Monzo banking API. Read-only access to accounts, balances, pots, transactions, and spending analysis - all through Claude Code or any MCP client.

Unlike other Monzo MCP implementations that use raw bearer tokens (which expire in 6 hours), this server handles full OAuth with automatic token refresh.

Features

  • 7 read-only tools - no write operations, no money movement
  • OAuth with auto-refresh - tokens refresh automatically, no manual regeneration
  • Local transaction cache - SQLite database survives Monzo's 90-day SCA window
  • Spending analysis - category breakdowns, top merchants, month-over-month comparison
  • Transaction search - search by merchant, description, or notes across cached history

Tools

Tool Description Data source
monzo_list_accounts List accounts with types and IDs Live API
monzo_get_balance Current balance and spend today Live API
monzo_list_pots Savings pots and balances Live API
monzo_sync Sync transactions to local cache Live API -> SQLite
monzo_list_transactions List/filter cached transactions Local cache
monzo_search_transactions Search by merchant/description/notes Local cache
monzo_spending Spending analysis with category breakdown Local cache

Prerequisites

  • Python 3.13+
  • uv (recommended) or pip
  • A Monzo account with an OAuth client registered at developers.monzo.com

Installation

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

Setup

1. Register a Monzo OAuth client

Go to developers.monzo.com and create an OAuth client:

  • Set the redirect URL to http://localhost:6600/callback
  • Note your Client ID and Client Secret

2. Authenticate

monzo-mcp auth

This opens your browser for Monzo OAuth. After authorizing, approve the login in your Monzo app within 5 minutes for full transaction history access (Monzo's SCA window).

3. Register with Claude Code

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. First sync

In Claude Code, run monzo_sync to populate the local transaction cache. Do this immediately after auth to take advantage of the SCA window (up to 11 months of history).

Configuration

All configuration is via environment variables (optional):

Variable Default Description
MONZO_MCP_CONFIG_DIR <package>/config/ Directory for OAuth credentials and tokens
MONZO_MCP_DB_PATH <package>/monzo.db Path to SQLite transaction cache

Credential files (created by monzo-mcp auth):

  • config/monzo_client.json - OAuth client ID and secret
  • config/monzo_tokens.json - Access and refresh tokens (auto-refreshed)

Monzo SCA window

Monzo's Strong Customer Authentication (SCA) limits transaction history access:

  • Within 5 minutes of app approval: up to ~11 months of history
  • After the window expires: only the last 90 days

The local SQLite cache preserves all synced transactions permanently, so run monzo_sync promptly after monzo-mcp auth.

Security

  • Zero write tools - cannot send money, move funds between pots, or modify transactions
  • Monzo API itself cannot send money to external accounts
  • Tokens stored as JSON files in the config/ directory (gitignored)
  • All API calls are GET requests with Bearer token auth

Contributing

See CONTRIBUTING.md for development setup, the test workflow, and the pre-commit hook. Changes are tracked in CHANGELOG.md.

License

GPL-3.0-or-later. See LICENSE.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About partymola/monzo-mcp

How do I install partymola/monzo-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is partymola/monzo-mcp safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is partymola/monzo-mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.