Finlynq
personal-financefinancebudgetinginvestmentsmcp
Open-source personal finance app with MCP tools for managing and analyzing income, spending, budgets, investments, loans, and goals.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Overview
Use cases
Track income, expenses, accounts, and subscriptions
Manage budgets, financial goals, loans, and investments
Import CSV, Excel, OFX/QFX, and PDF financial files
Analyze portfolios, FIRE projections, and Monte Carlo simulations
Automate categorization, rules, splits, and bulk edits
Key features
54 HTTP and 89 stdio MCP tools
Read and write access to personal finance data
AES-256-GCM encryption with scrypt-derived keys
CSV, Excel, OFX/QFX, and PDF imports
OAuth 2.1, Dynamic Client Registration, and bearer API keys
Self-hosted Docker and PostgreSQL deployment
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Finlynq.
Extracted Tool Capabilities
54 HTTP and 89 stdio MCP tools
Read and write access to personal finance data
AES-256-GCM encryption with scrypt-derived keys
CSV, Excel, OFX/QFX, and PDF imports
OAuth 2.1, Dynamic Client Registration, and bearer API keys
Self-hosted Docker and PostgreSQL deployment
Documentation Overview
Finlynq
Two ways to use Finlynq: a free managed cloud at finlynq.com/cloud, or self-host with Docker.
Open-source personal finance with a first-party MCP server (54 HTTP / 89 stdio tools) so Claude, ChatGPT, Cursor, etc. can query and manage your finances.
Track your money here, analyze it anywhere.
Quick start — hosted
finlynq.com/cloud — click, register, import a CSV. No infra to manage.
A public demo lives at finlynq.com/cloud?demo=1 (credentials pre-filled, resets nightly). Connect it to Claude by pasting https://finlynq.com/mcp into Claude → Customize → Connectors.
Quick start — self-hosted
Before the first up, create a sibling .env file with three secrets, each generated with openssl rand -hex 32: PF_JWT_SECRET, PF_PEPPER (≥32 chars), and PF_STAGING_KEY (≥32 chars). Compose fails fast with a clear message if any is missing. Then open http://localhost:3000 and register. App + PostgreSQL run in Docker; sensitive fields are encrypted at rest with a per-user key derived from the account password. Change the default PostgreSQL password (POSTGRES_PASSWORD in .env) before exposing the container to anything but localhost. Full setup notes at finlynq.com/self-hosted.
Features
- 100+ MCP tools (HTTP & stdio) — read & write
- AES-256-GCM envelope encryption · scrypt-derived KEK
- CSV, Excel, OFX/QFX, PDF import
- Budgets, portfolio, goals, loans
- Natural-language AI chat
- FIRE calculator & Monte Carlo sim
- Rules & auto-categorize
- Self-host or managed cloud
- REST API + MCP (HTTP & stdio · OAuth 2.1 + DCR)
- Dark mode, mobile-friendly UI
MCP server
First-party Model Context Protocol server with 54 HTTP / 89 stdio tools covering accounts, transactions, budgets, goals, loans, portfolio, subscriptions, FX rates, rules, splits, bulk edits, and file imports.
- Claude Web / Mobile / Cursor / Windsurf — OAuth 2.1 + Dynamic Client Registration. Paste
https://finlynq.com/mcpinto the connector setup; no config file. - Claude Desktop (stdio) — point at
mcp-server/index.tswithPF_USER_IDin the env block. - Bearer API key — generate a
pf_*token in Settings → API Keys for scripts and REST clients.
Submitted to the Anthropic Connectors Directory on 2026-05-09. Full client setup, tool catalog, and the brokerage-statement recipe live in the Connect Your AI guide.
License
AGPL v3. If you run a modified version as a network service, you owe your users the source. The hosted offering at finlynq.com/cloud runs the same code as this repo.
Building something on Finlynq that can't carry that obligation? A commercial license is available, see COMMERCIAL.md.
Donation-based. No paid tiers. If Finlynq is useful to you, GitHub Sponsors or Ko-fi keep it shipping.
Docs
- CHANGELOG.md — reverse-chronological log of every shipped change
- docs/getting-started.md — first-run setup walkthrough
- docs/faq.md — common questions
- docs/mobile-setup.md — connect the companion mobile app
- Connect Your AI guide — MCP architecture, tool catalog, and per-client setup
- CONTRIBUTING.md — branching, commit style, PR flow
- SECURITY.md — vulnerability disclosure
Related MCP Servers
Frequently Asked Questions about Finlynq
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/finlynq-finlynq)HTML Embed
<a href="https://allmcps.com/mcp/finlynq-finlynq"><img src="https://allmcps.com/api/badge/finlynq-finlynq?style=directory" alt="Finlynq on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
PricingFree
55Quality signal: Good · 55/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools25/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.
Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.