Lunchmoney MCP Server
Overview
Lunchmoney MCP Server is a Model Context Protocol (MCP) server that allows users to interact with their Lunchmoney transactions and budgets through AI assistants like Claude.
To use the Lunchmoney MCP Server, install it via Smithery or configure it directly in Claude Desktop with your Lunchmoney API token. You can then ask questions related to your transactions and budgets.
- Get recent transactions: View recent transactions from the past N days. - Search transactions: Search transactions by keywords in payee names or notes. - Analyze spending: Get insights on spending in specific categories. - Budget summary: Access detailed budget information including spending, remaining amounts, and recurring items.
- Tracking recent transactions for better financial awareness.
- Searching for specific transactions to analyze spending habits.
- Monitoring budget status and remaining amounts in various categories.
- Generating reports on spending trends over time.
Add to your AI client
Use these steps to connect Lunchmoney MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"lunchmoney-mcp-server-leafeye": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"lunchmoney-mcp-server-leafeye": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"lunchmoney-mcp-server-leafeye": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"lunchmoney-mcp-server-leafeye": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"lunchmoney-mcp-server-leafeye": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"lunchmoney-mcp-server-leafeye": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-lunchmoney-mcp-server-leafeye"
]
}
}
}FAQ
Can I use Lunchmoney MCP Server without installation?
Yes! You can use it directly in Claude Desktop without installation by configuring it with your API token.
What is the Model Context Protocol (MCP)?
MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs), allowing for seamless integration with various data sources and tools.
Is the Lunchmoney MCP Server open-source?
Yes! The Lunchmoney MCP Server is open-source and contributions are welcome.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1352,"uuid":"c6c78aa0-338d-4eaf-94ef-7f78a1de8121","name":"lunchmoney-mcp-server","title":"Lunchmoney MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/43389483?v=4","created_at":"2025-02-20T15:29:28.518Z","updated_at":"2025-02-23T07:21:17.883Z","status":"created","author_name":"leafeye","author_avatar_url":"https://avatars.githubusercontent.com/u/43389483?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/leafeye/lunchmoney-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"7\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-05-01 09:42:44\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]