Monobank MCP Server (Node.js/TypeScript)

Node.js/TypeScript implementation of the Monobank MCP Server originally written in Python.

Monobank MCP Server exposes your Monobank personal account as Model Context Protocol (MCP) tools.

About This Version

This is a Node.js/TypeScript port of the original Python implementation by @nklymok.

• Original Python version: https://github.com/nklymok/Monobank-MCP

• This TypeScript version: Maintains the same functionality with Node.js/TypeScript ecosystem benefits

Features

• TypeScript/Node.js MCP server using the official @modelcontextprotocol/sdk

• Two ready-to-use MCP tools:

  • get_client_info – returns client, accounts and jars metadata.

  • get_statement – returns account statement for a given period (≤ 31 days).

Usage (Published Package)

The easiest way to use this MCP server is via the published npm package:

1. Register the server in your MCP configuration

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

2. Run your MCP client – the two tools will be available immediately.

Development

If you want to contribute or modify the server:

1. Clone and install dependencies

   git clone https://github.com/your-username/Monobank-MCP.git
   cd Monobank-MCP
   npm install

2. Set your Monobank API token (choose one method):

   Windows (PowerShell):

   $env:MONOBANK_API_TOKEN="your_token_here"
   npm start

   Windows (Command Prompt):

   set MONOBANK_API_TOKEN=your_token_here
   npm start

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   npm start

   Or run directly with environment variable:

   MONOBANK_API_TOKEN=your_token_here npm start

3. For development with hot reload:

   MONOBANK_API_TOKEN=your_token_here npm run dev

Tool Reference

API Token

To use this server, you need a personal Monobank API token. You can get one from the official Monobank API documentation: https://api.monobank.ua/index.html

Environment Variables

License

MIT