Up Bank

You can interact with the Up Bank API through an MCP server that exposes account, transaction, category, tag, and webhook management. This MCP server acts as a bridge between MCP-enabled clients and the Up Bank API, making it easy to perform common banking operations from tools like Claude for Desktop.

How to use

Configure your MCP-enabled client to connect to the local MCP server, then use the provided tools to manage accounts, transactions, categories, tags, and webhooks with Up Bank.

How to install

Prerequisites tell you what you need before installation.

# Prerequisites
# Python 3.10 or higher (required)
# uv package manager (required)

# Install uv (example command shown in setup steps)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Restart your terminal after installation

# Clone the MCP server repository and enter the project
git clone <repository-url>
cd up-mcp

# Set up a virtual environment using uv
uv venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

# Install Python dependencies
uv pip install -r requirements.txt

Configuration and usage notes

The MCP server for Up Bank runs as a local process started through uv and is configured via a client-side MCP configuration JSON. Use the following configuration to register the server with your MCP-enabled client.

{
  "mcpServers": {
    "up-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/up-mcp",
        "run",
        "up_mcp.py"
      ],
      "env": {
        "UP_TOKEN": "up:yeah:your-token-here"
      }
    }
  }
}

Testing

You can verify the server by running the included test script to exercise basic functionality such as retrieving accounts and listing transactions.

python test.py

Troubleshooting and notes

If you run into issues, review the environmental token and dependency setup first. Ensure you are using a Python 3.10+ runtime and that the uv runtime is correctly installed. If problems persist, check the client logs for MCP-related messages and confirm that the UP_TOKEN environment variable is set to a valid Up Bank API token.

Available tools

Account management

Get accounts, retrieve a specific account, and inspect account details.

Transaction management

List transactions, fetch a specific transaction, and review transaction history.

Category management

Retrieve categories and categorize transactions to organize spending.

Tag management

Get tags and add or remove tags from transactions.

Webhook management

Create, delete, and ping webhooks to receive updates from Up Bank.