Monobank — Claude Code MCP server: install
Connects an AI coding client to Monobank exchange rates, client data, and statements. Useful for checking balances and transactions from a chat.
claude mcp add monobank-mcp-server -e MONOBANK_API_TOKEN=<MONOBANK_API_TOKEN> -- npx -y monobank-mcp-serverWhat Monobank does
Monobank exposes three MCP tools: current currency rates, client details with accounts and jars, and statements for an account or jar. Currency rates use a public endpoint, while the other two tools require authentication.
Run it with Node.js 18.0.0 or newer and set MONOBANK_API_TOKEN. Monetary values are returned as currency units rather than minor units. Statement dates use ISO 8601 in UTC, the end date is included, and a range can cover up to 31 days plus 1 hour. Without the token, the server still starts, but get_client_info and get_statement return an error.
What it helps with
- check current exchange rates
- inspect account and jar balances
- retrieve a statement for a date range
- review recent spending transactions
Example prompts for the agent
- Show the current USD to UAH rate through Monobank.
- Check my account balances and recent transactions.
- Get a statement from 2024-10-01 through 2024-10-31.
How to install Monobank
Platform CLI
claude mcp add monobank-mcp-server -e MONOBANK_API_TOKEN=<MONOBANK_API_TOKEN> -- npx -y monobank-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add monobank --env MONOBANK_API_TOKEN=<MONOBANK_API_TOKEN> -- npx -y monobank-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"monobank": {
"command": "npx",
"args": [
"-y",
"monobank-mcp-server"
],
"env": {
"MONOBANK_API_TOKEN": "<MONOBANK_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"monobank": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"monobank-mcp-server"
],
"env": {
"MONOBANK_API_TOKEN": "<MONOBANK_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MONOBANK_API_TOKEN=<MONOBANK_API_TOKEN> monobank npx -y monobank-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Monobank
How do I install Monobank in Claude Code?
Run claude mcp add monobank-mcp-server -e MONOBANK_API_TOKEN=<MONOBANK_API_TOKEN> -- npx -y monobank-mcp-server.
What does Monobank do?
This MCP server gives the agent access to exchange rates, client details, accounts, jars, and account or jar statements.
Which Monobank tools need an API token?
get_client_info and get_statement need MONOBANK_API_TOKEN. get_currency_rates works without it, and the server can start before the token is set.
