ClearFi Finance MCP Server

Give your AI assistant a clear picture of your finances. This MCP server connects Claude (or any MCP-compatible AI) to the ClearFi personal finance API, providing tools to search transactions, track bills, analyze spending, and manage accounts.

The AI helps you see your financial data clearly — it doesn't make decisions for you.

What It Does

• Search and categorize bank transactions

• Track recurring bills and income with a financial calendar

• Analyze spending by category or merchant

• Manage bank accounts (Plaid-connected and manual)

• Import transactions from CSV files

• Sync fresh data from connected banks

• Match transactions to scheduled bills

Related MCP server: Lunch Flow MCP Server

Prerequisites

• Python 3.10+

• A ClearFi account with an API key

• Network access to the ClearFi API

Install

git clone https://github.com/YOUR_USERNAME/clearfi-finance-mcp.git
cd clearfi-finance-mcp
pip install -r requirements.txt

Or install dependencies directly:

pip install fastmcp httpx

Get an API Key

1. Log in to ClearFi

2. Go to Settings > AI Agents

3. Click Create Agent, choose a role and permissions

4. Copy the API key (shown once)

Configure

Claude Code

Add to your project's .mcp.json (or ~/.claude/settings.json for global access):

{
  "mcpServers": {
    "clearfi-finance": {
      "command": "python",
      "args": ["/path/to/clearfi-finance-mcp/mcp_server.py"],
      "env": {
        "API_URL": "https://aifinancial.thehandle.app/api",
        "API_KEY": "gcal_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "clearfi-finance": {
      "command": "python",
      "args": ["/path/to/clearfi-finance-mcp/mcp_server.py"],
      "env": {
        "API_URL": "https://aifinancial.thehandle.app/api",
        "API_KEY": "gcal_your_api_key_here"
      }
    }
  }
}

Using uv (alternative)

If you use uv instead of pip:

{
  "mcpServers": {
    "clearfi-finance": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "--with", "httpx", "/path/to/clearfi-finance-mcp/mcp_server.py"],
      "env": {
        "API_URL": "https://aifinancial.thehandle.app/api",
        "API_KEY": "gcal_your_api_key_here"
      }
    }
  }
}

Available Tools

Resources (Auto-loaded Context)

Example Prompts

Once configured, try asking your AI:

• "What are my account balances?"

• "How much did I spend on groceries this month?"

• "Show me all transactions from Chase over $50"

• "What bills are coming up in the next two weeks?"

• "Create a monthly expense called Rent for $1500 starting March 1st"

• "Categorize that Starbucks transaction as Dining"

• "Sync my latest transactions from the bank"

Security

• The MCP server script contains no secrets — API keys are passed via environment variables

• API keys are scoped by role (viewer/member) and permissions (read/write per data type)

• Each AI agent can be restricted to specific bank accounts

• Keys can be revoked at any time from the ClearFi settings page

License

MIT