MCP.so
Sign In
P

Personal Finance MCP

@JosueM1109

Repository

About Personal Finance MCP

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#self-hosted#read-only#python#fastmcp#claude-code#banking#transactions#investments

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 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. It lets you ask questions about your own finances in plain English without a third-party aggregator like Monarch or Mint. This is an unofficial project not affiliated with Plaid Inc.

How to use Personal Finance MCP?

Requires Python 3.11+, a free Plaid Trial plan (up to 10 Items), and an MCP client like Claude Code. Clone the repository, install dependencies, copy .env.example to .env and fill in Plaid credentials. Run uvicorn link_helper:app --port 8765 once per bank to generate access tokens, then run python server.py to serve the server on http://localhost:8000/mcp. Add it to Claude Code with claude mcp add --transport http personal-finance http://localhost:8000/mcp.

Key features of Personal Finance MCP

  • Nine read-only tools: list_accounts, get_balances, get_transactions, search_transactions, get_recurring_transactions, get_liabilities, get_investment_holdings, get_investment_transactions, and get_institutions_status
  • Self-hosted and single-tenant – one deployment per person
  • No third‑party aggregator; connects directly via Plaid
  • All tools are read‑only, never mutating financial data
  • Credentials stored in environment variables, never on disk

Use cases of Personal Finance MCP

  • Ask “What’s my total balance across all accounts?” in Claude Code
  • Find transactions over $100 in the last 30 days
  • Discover which subscriptions you’re still paying for
  • Query how much was spent on groceries last month
  • Check which banks need re‑authentication

FAQ from Personal Finance MCP

How is Personal Finance MCP different from Monarch or Mint?

It connects directly via Plaid without a third‑party aggregator; it is self‑hosted and purely read‑only.

What are the prerequisites to run Personal Finance MCP?

Python 3.11+, a free Plaid Trial plan (up to 10 Items), and an MCP client such as Claude Code.

Is Personal Finance MCP affiliated with Plaid?

No, it is unofficial and not affiliated with Plaid Inc.

Where does my financial data reside?

Data is fetched live from Plaid each time a tool is called; tokens are stored in environment variables and never written to disk.

What transport does Personal Finance MCP use?

It serves on HTTP at localhost:8000/mcp and can be added to Claude Code via the HTTP transport.

Frequently asked questions

How is Personal Finance MCP different from Monarch or Mint?

It connects directly via Plaid without a third‑party aggregator; it is self‑hosted and purely read‑only.

What are the prerequisites to run Personal Finance MCP?

Python 3.11+, a free Plaid Trial plan (up to 10 Items), and an MCP client such as Claude Code.

Is Personal Finance MCP affiliated with Plaid?

No, it is unofficial and not affiliated with Plaid Inc.

Where does my financial data reside?

Data is fetched live from Plaid each time a tool is called; tokens are stored in environment variables and never written to disk.

What transport does Personal Finance MCP use?

It serves on HTTP at `localhost:8000/mcp` and can be added to Claude Code via the HTTP transport.

Comments

Basic information

Category

Finance & Commerce

Transports

stdio

Author

JosueM1109

Submitted by

Josue Mendives

More Finance & Commerce MCP servers

U

Unquant

Streetbeat

Hosted financial-data MCP for AI agents: 28 tools for market and company data, financial news, macroeconomics, and US Congress disclosures. Streamable HTTP with an anonymous Free allowance plus OAuth. Delayed/end-of-day

Fakto.app - wFirma MCP Server

Fakto.app

The only MCP server for wFirma.pl (Polish accounting). Full read-write: AI assistants create and search invoices, manage contractors, expenses, payments, warehouse, KPiR and ZUS, plus reports and cashflow forecasts. OAut

Cliometry

Cliometry

Live Korean market measurements for AI agents — SK Hynix ADR premium, realized leverage multiples for KODEX/SOXL/TQQQ, VIX regime, Korean semiconductor sector RRG. Pre-computed daily values, structured responses, CC BY 4

govtrade-mcp

iamdarcie

Wraps the live GovTrade x402 API as MCP tools any agent can call directly — get congressional trade signals , get congressional trades , and get politician trading baseline . This server pays your live x402 endpoints on

IBANforge

cammac-creator

IBANforge — IBAN validation, BIC/SWIFT lookup, Swiss clearing, and EMI/vIBAN classification API with MCP for AI agents

3