“Compare last month’s income and expenses with the previous month.”
Query spending categories, cash flow and financial reports using the data already in your ledger.
GuGuFin for macOS · Model Context Protocol
Connect your AI agent to your own financial records.
Ask about expenses, organize financial reports and reconcile credit card statements. GuGuFin provides financial data and tools; you choose the MCP-compatible agent.
A macOS menu bar app. Your client needs local Streamable HTTP MCP and Bearer Token support. Setup varies by client.
Start with a question about your finances
“Help me reconcile this credit card statement.”
Let your agent structure external statement rows, preview matching suggestions and review unmatched or potentially deferred transactions.
“Prepare this expense in the selected ledger for my review.”
Prepare supported income, expense, investment and recurring-expense proposals. Supply missing amounts, accounts and dates before proceeding.
Your agent understands the request. GuGuFin handles accounting rules.
- Describe your question or request
- The agent calls GuGuFin MCP tools
- Review results or a complete write proposal
- Explicitly approve a supported write
How do you connect Codex, Claude Desktop or another MCP client?
- Open GuGuFin on Mac, import a backup and unlock the ledger workspace you want to use.
- Start MCP Server from the menu bar and copy the MCP configuration generated by the app.
- Configure the HTTP endpoint and Authorization header for your client. Query the ledger list first to check the connection and data source.
Transport and authentication support varies across Codex, Claude Desktop, Cursor and other clients. Follow the client’s documentation if a bridge is required. The generic JSON is not a universal drop-in configuration.
Read the MCP setup guide →Local storage and AI data transmission are separate choices
The MCP endpoint binds to your Mac’s loopback interface and uses Bearer Token authentication. Tool results are handed to your chosen agent; a cloud AI service may process them on its servers. Ledgers with iCloud sync enabled also sync through Apple. Choose your client and sync settings accordingly.
Questions before you connect
Does the phone app host an MCP server?
This page covers the macOS MCP Server. Use your phone for bookkeeping and backup export; the Mac provides the MCP connection.
Can an agent execute arbitrary SQL or change records freely?
The server exposes accounting tools, not an arbitrary SQL interface. Writes use proposals and confirmation. Your agent should show the complete proposal and obtain explicit approval before calling the confirmation tool.
Does it provide live bank sync or real-time market prices?
MCP queries the currently loaded ledger. Check the data timestamp, exchange rates and market-data sources. It is not a direct bank connection and does not guarantee real-time prices.