Finance Intelligence MCP Server
Finance Intelligence MCP is a production-ready server that enables AI assistants (like Claude, Cursor, and others) to securely manage and analyze personal finances through natural language.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
uvx finance-intelligence-mcp==1.0.0O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
DATABASE_URL=<secret> claude mcp add io.github.ronit-019-finance-intelligence-mcp -- uvx finance-intelligence-mcp==1.0.0Execute em um terminal.
{ "mcpServers": { "io.github.ronit-019-finance-intelligence-mcp": { "command": "uvx", "args": [ "finance-intelligence-mcp==1.0.0" ], "env": { "DATABASE_URL": "<secret>" } } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
Released under the MIT License and designed to be extended with additional finance tools.
Unlike standard cloud-based personal finance apps, Finance Intelligence MCP keeps all financial data under your absolute control.
┌────────────────────────────────┐
│ MCP Client │
│ (Claude Desktop, Cursor, etc) │
└───────────────┬────────────────┘
│
│ (STDIO Transport Protocol)
▼
┌────────────────────────────────┐
│ Finance Intelligence Server │
│ (Local) │
└───────────────┬────────────────┘
│
│ (Direct SQL Pool Connection)
▼
┌────────────────────────────────┐
│ PostgreSQL Database │
│ (Supabase, Local, RDS, etc) │
└────────────────────────────────┘
overall spending, specific category thresholds, or down to nested subcategory targets.stdioIf you have uv installed, get started in 2 lines:
git clone https://github.com/Ronit-019/Finance-Intelligence-MCP.git
cd Finance-Intelligence-MCP
uv sync
The easiest, free option is Supabase:
postgresql://postgres.[your-project-ref]:[your-password]@aws-0-us-east-1.pooler.supabase.com:5432/postgres[your-password] with your database password).Clone the codebase to a directory on your machine:
git clone https://github.com/Ronit-019/Finance-Intelligence-MCP.git
cd Finance-Intelligence-MCP
Copy the absolute path of this directory (e.g. C:/Users/Admin/Desktop/Finance-Intelligence-MCP).
Note: Always use forward slashes (/) for paths in JSON configs.
If you do not have uv installed, install from the project metadata:
pip install -e .
claude_desktop_config.json):
Win + R, paste %APPDATA%\Claude\claude_desktop_config.json and press Enter.~/Library/Application Support/Claude/claude_desktop_config.json in Finder's Go to Folder.mcpServers:{
"mcpServers": {
"finance-intelligence": {
"command": "uv",
"args": [
"--directory",
"REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY",
"run",
"python",
"main.py"
],
"env": {
"DATABASE_URL": "REPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRING"
}
}
}
}
Finance Intelligencecommanduv --directory "REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY" run python main.py
DATABASE_URLREPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRINGOnce configured, try talking to your AI assistant:
The server registers 12 core tools on the client:
uv: command not foundIf the client cannot locate uv, update your config file to run standard Python:
pip install -e . inside the repository."finance-intelligence": {
"command": "python",
"args": [
"REPLACE_WITH_ABSOLUTE_PATH_TO_CLONED_DIRECTORY/main.py"
],
"env": {
"DATABASE_URL": "REPLACE_WITH_YOUR_SUPABASE_CONNECTION_STRING"
}
}
DATABASE_URL / PostgreSQL Connection Errors[your-password] with your actual database password in the Supabase URI string.claude_desktop_config.json use forward slashes (/), even on Windows.%APPDATA%\Claude\logs\mcp*.log (Windows) or ~/Library/Logs/Claude/mcp*.log (macOS) to see the exact startup error.├── src/ # Helper packages
│ ├── __init__.py
│ ├── budget.py # Budget database operations
│ ├── analytics.py # Breakdown aggregations & Matplotlib routines
│ └── health.py # KPIs and financial health calculator
├── main.py # FastMCP Server application
├── categories.json # Category mapping catalog
├── pyproject.toml # Dependencies
├── LICENSE # MIT License file
└── README.md # This file
Contributions, bug reports, and feature requests are welcome! Please open an issue before submitting major changes or pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
Ronit Rajput
Personal finance MCP server with budgeting, analytics, and PostgreSQL.
{ "mcpServers": { "io.github.ronit-019-finance-intelligence-mcp": { "command": "uvx", "args": [ "finance-intelligence-mcp==1.0.0" ], "env": { "DATABASE_URL": "<secret>" } } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
O publicador lista estas variáveis de ambiente: DATABASE_URL.
Finance Intelligence roda localmente via stdio.
Última verificação: 2026-11-09. Personal finance MCP server with budgeting, analytics, and PostgreSQL.