monobank-mcp

MCP server for Monobank — exposes your accounts, transactions, exchange rates, and webhook configuration as tools for Claude and other MCP clients.

Responses are pre-processed for LLM consumption: amounts are in base currency units (not cents), timestamps are ISO 8601, currency codes are ISO 4217 strings, and permissions are decoded to human-readable names. Frequently-accessed data is cached server-side for 1 hour so repeated reads never hit the Monobank rate limit.

Quick Start — Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "monobank": {
      "command": "npx",
      "args": ["-y", "@dirgen/monobank-mcp"],
      "env": {
        "MONOBANK_API_TOKEN": "your_token_here"
      }
    }
  }
}

Related MCP server: Bunq MCP

Quick Start — Claude Code

claude mcp add monobank -- npx -y @dirgen/monobank-mcp

Then add your token to .claude/settings.json:

{
  "mcpServers": {
    "monobank": {
      "env": { "MONOBANK_API_TOKEN": "your_token_here" }
    }
  }
}

Getting a Token

Open api.monobank.ua and scan the QR code with the Monobank app to generate your personal API token. The token never leaves your machine — it is passed directly to the server process as an environment variable.

Available Tools

Public — no token required

Personal — requires MONOBANK_API_TOKEN

Caching

The server caches responses to stay within Monobank's rate limits and avoid redundant API calls:

Webhook mutations automatically invalidate the client-info cache so the next read reflects the updated URL.

Rate Limits

Monobank personal endpoints allow 1 request per 60 seconds. If the limit is hit, the server returns a clear error message telling you to wait 60 seconds. The 1-hour cache means most repeated reads are served locally without hitting the API at all.

Developer Setup

Requires Node.js ≥ 24.17.0 and pnpm.

git clone https://github.com/todesstoss/monobank-mcp
cd monobank-mcp
pnpm install

Create a .env file:

MONOBANK_API_TOKEN=your_token_here

pnpm start       # run the MCP server
pnpm inspect     # open MCP Inspector in the browser for interactive testing
pnpm typecheck   # type-check without emitting
pnpm lint        # lint src/

Troubleshooting

Invalid token / 401 — regenerate your token at api.monobank.ua. Tokens expire if unused.

Rate limit / 429 — wait 60 seconds. The server will tell you when this happens. Repeated reads within an hour are served from cache and won't trigger this.

Statement range > 31 days — split the request into multiple calls, each covering ≤ 31 days. The tool will tell you if the range is too wide.

Currency pair not found — use monobank-bank-currency to see all available pairs. Only UAH pairs and EUR/USD are available.

No managedClients in client-info — this field only appears if you are registered as a FOP (sole proprietor) with Monobank. All tokens are the same personal token — managedClients is simply absent if you have no FOP accounts.

License

MIT