finlynq
finlynq/finlynq
Open-source (AGPL v3) personal finance app with a first-party MCP server. Track your money here, analyze it anywhere — query your finances from Claude, Cursor, or any MCP client. Self-host with Docker or use the free cloud.
Instalação
npx convez-ai finlynq/finlynq1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
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 (91 HTTP / 87 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 the same URL (username demo / password finlynq-demo, resets nightly). Connect it to Claude by pasting https://finlynq.com/mcp into Claude → Customize → Connectors.
Quick start — self-hosted
curl -O https://raw.githubusercontent.com/finlynq/finlynq/main/pf-app/docker-compose.yml
docker compose up -d
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. Remember to change the default PostgreSQL password and PF_JWT_SECRET before exposing the container to anything but localhost. Full setup notes at finlynq.com/self-hosted.
Features
- 90 MCP tools (HTTP) · 86 (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 91 HTTP / 87 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 architecture, tool catalog, and the brokerage-statement recipe live in docs/architecture/mcp.md.
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.
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/architecture/ — encryption, MCP internals, database, migrations
- docs/import-connectors.md — adding a new file-import provider
- CONTRIBUTING.md — branching, commit style, PR flow
- SECURITY.md — vulnerability disclosure