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.
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
uvx finance-intelligence-mcp==1.0.0Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
DATABASE_URL=<secret> claude mcp add io.github.ronit-019-finance-intelligence-mcp -- uvx finance-intelligence-mcp==1.0.0Ejecútalo en una 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 o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en 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.
AbrirDel 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>" } } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
El publicador indica estas variables de entorno: DATABASE_URL.
Finance Intelligence se ejecuta localmente por stdio.
Última comprobación: 2026-11-09. Personal finance MCP server with budgeting, analytics, and PostgreSQL.