💰

Monobank MCP Server

An MCP server that brings your Monobank account data directly into AI conversations.

0 installs

Trust: 34 — Low

Finance

Ask AI about Monobank MCP Server

I know everything about Monobank MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

About

A Model Context Protocol (MCP) server that brings your Monobank account data directly into AI conversations. Access account balances, transaction history, and currency rates seamlessly within Claude Desktop and other MCP-compatible applications through Monobank's official open API.

Features

Real-time Currency Rates: Access current exchange rates from Monobank
Client Information: View your profile, accounts list, and associated jars
Transaction History: Retrieve statements for any period (up to 31 days)
Account Overview: Get a comprehensive summary of your banking activity
Smart Prompts: Pre-built templates for common banking queries
Selectable Resources: Choose specific data sources to give AI context about your account

Prerequisites

To use this MCP server, you need:

A Monobank account
API access token (obtain from Monobank API Portal)
Claude Desktop or another MCP-compatible client
(For Docker method) Docker installed on your system

Getting Started

Using Docker (Recommended)

Note: Requires Docker to be installed on your system.

Pull the Docker image:

 docker pull makyarm/monobank-mcp-server:latest

Configure your MCP client (e.g., Claude Desktop):

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "monobank": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MONOBANK_API_TOKEN=your_api_token",
        "makyarm/monobank-mcp-server:latest"
      ]
    }
  }
}
```
Replace your_api_token with your actual Monobank API token.
Restart Claude Desktop to load the new configuration.

Manual Installation

Clone and build the project:

git clone https://github.com/yourusername/monobank-mcp-server.git
cd monobank-mcp-server
mvn clean package

The JAR file will be created in the /target directory.

Configure your MCP client (e.g., Claude Desktop):

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "monobank": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/target/monobank-mcp-server.jar"
      ],
      "env": {
        "MONOBANK_API_TOKEN": "your_api_token"
      }
    }
  }
}
```
Replace /absolute/path/to/target/monobank-mcp-server.jar with the actual path to your JAR file and your_api_token with your Monobank API token.
Restart Claude Desktop to load the new configuration.

Available Tools

Once configured, the MCP server provides the following tools, resources and prompts that can be used in your AI conversations:

🏦 Monobank Tools

Core tools for accessing Monobank banking services:

retrieve_all_currencies - Get current exchange rates for all currencies from Monobank
retrieve_client_information - Retrieve your Monobank account information, balance, and card details
retrieve_statements - Fetch transaction history for a specified account and time period (up to 31 days)

🛠️ Utility Tools

Helper tools to enhance functionality:

resolve_time_to_epoch - Parse natural-language date/time expressions (like "two weeks ago" or "December 1, 2025") and convert them to Unix epoch timestamps for use with statement retrieval

📚 Resources

Structured resources that can be attached to conversations to give Claude context about your account:

monobank://bank/currency-rates - Real-time exchange rates for all currency pairs (cached by bank ~5 min)
monobank://personal/client-info - Your complete account profile, balances, and card information
monobank://personal/statements - Recent transaction history from your primary account

Resources are automatically available when needed, or you can explicitly reference them in your queries.

💬 Prompts

Pre-configured prompt templates for common use cases:

Account Overview - Generates a comprehensive overview of your Monobank account, including balances and recent activity
Interpret Monobank Statements - Provides rules for analyzing and reasoning about transaction statements
Interpret Monobank Currency Record - Guidelines for understanding currency exchange rate data
Interpret Monobank Client Information - Instructions for interpreting account, jar, and client profile data

Prompts help Claude better understand and analyze your Monobank data with domain-specific context.

Example Usage

Check your spending this month:

"Show me my transactions from the beginning of this month"
→ Automatically converts time expressions and fetches your statements

Monitor exchange rates:

"What's the current USD to UAH exchange rate?"
→ Retrieves live exchange rates from Monobank

Generate a financial summary:

"Summarize my spending for the last two weeks"
→ Analyzes your recent transactions and provides insights

Important Notes

⚠️ Security: Keep your API token private and never share it publicly. It provides access to your personal banking data.

🔒 Read-Only: This server provides read-only access to your Monobank data. It cannot perform transactions or modify your account.

⏱️ Rate Limits: Monobank API has rate limits. Avoid making excessive requests in short periods.

Disclaimer

This project is not affiliated with Monobank. It was created independently to facilitate integration of Monobank's banking services with MCP-compatible applications.

Made with ❤️ for the Monobank community