Personal Finance MCP

Created By

JosueM110916 days ago

Self-hosted, read-only MCP server for personal finance. Connect your banks, credit cards, loans, and brokerage accounts via Plaid and query them from Claude Code in plain English — no third-party aggregator involved.

# plaid

# personal-finance

Overview Content Tools Comments

Overview

Personal Finance MCP

A self-hosted, read-only MCP server that connects your banks, credit cards, loans, and brokerage accounts (via Plaid) to Claude Code. Ask questions about your own finances in plain English — no Monarch, no Mint, no third-party aggregator.

Unofficial. Not affiliated with Plaid Inc. Self-hosted client using credentials you supply.

What you can ask

"What's my total balance across all accounts?"
"Show me transactions over $100 in the last 30 days."
"Which subscriptions am I still paying for?"
"How much did I spend on groceries last month?"
"Any bank that needs re-authentication?"

Tools (9, all read-only)

Tool	What it does
`list_accounts`	Every account across every linked bank, with balances
`get_balances`	Live current + available balances
`get_transactions`	Transactions in a date range (up to 2 years back)
`search_transactions`	Keyword search across merchant / name / counterparty
`get_recurring_transactions`	Detected recurring inflow + outflow streams
`get_liabilities`	Credit cards, student loans, mortgages with APRs
`get_investment_holdings`	Current holdings with symbol + security metadata
`get_investment_transactions`	Buy / sell / dividend history in a date range
`get_institutions_status`	Health of each linked bank (surfaces re-auth needs)

Quickstart

Requires Python 3.11+, a Plaid account (free Trial plan, 10 Items), and an MCP client.

Sign up at plaid.com → Trial plan → enable Transactions, Liabilities, Investments.
Clone the repo, install requirements, copy .env.example to .env, fill in Plaid credentials.
Run uvicorn link_helper:app --port 8765 once per bank to generate access tokens.
Run python server.py — serves on http://localhost:8000/mcp.

Add to Claude Code:

claude mcp add --transport http personal-finance http://localhost:8000/mcp

Full setup, deployment (Docker, Fly.io, Raspberry Pi, Prefect Horizon), and security notes in the GitHub README.

Security

Single-tenant. One deployment per person. Don't share.
Read-only. No tool mutates state at any institution.
Tokens live in env vars, never on disk. .env is gitignored.
You own Plaid compliance — you're the Plaid customer under your own account.

License

MIT

Server Config

{
  "mcpServers": {
    "personal-finance": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8000:8000",
        "-e",
        "PLAID_CLIENT_ID",
        "-e",
        "PLAID_SECRET",
        "-e",
        "PLAID_ENV",
        "personal-finance-mcp"
      ],
      "env": {
        "PLAID_CLIENT_ID": "<YOUR_PLAID_CLIENT_ID>",
        "PLAID_SECRET": "<YOUR_PLAID_SECRET>",
        "PLAID_ENV": "production"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

WindsurfThe new purpose-built IDE to harness magic

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Tavily Mcp