penni-mcp
Provides integration with QuickBooks Online, enabling AI agents to access financial data, generate reports, create invoices and expenses, and manage bookkeeping tasks through the QuickBooks platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@penni-mcp what's my profit and loss for last quarter?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
penni-mcp
Penni — AI bookkeeper for small businesses. Connect your QuickBooks and manage your books through Claude Desktop or Cursor.
Quick Start
npx penni-mcpOn first run, you'll be prompted for your API key. Get yours at app.penni.so/dashboard/mcp.
Related MCP server: quickbooks-mcp-server
Claude Desktop Setup
Add to your claude_desktop_config.json:
{
"mcpServers": {
"penni": {
"command": "npx",
"args": ["penni-mcp"]
}
}
}Config file location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Then restart Claude Desktop and ask: "What's my bank balance?"
Cursor Setup
Settings → MCP → Add Server:
Name: penni
Command:
npx penni-mcp
What You Can Do
Free (connect QBO and go)
"What's my bank balance?" — real-time balances from QuickBooks
"Show me my P&L for this month" — Profit & Loss report
"Who owes me money?" — open and overdue invoices
Paid ($149/mo at penni.so)
"Create a $500 expense for AWS under Software" — post expenses to QBO
"Invoice Acme Corp $2,000 for consulting, due May 1st" — create and send invoices
"Ask Penni: what's my biggest expense category?" — AI-powered bookkeeping Q&A
How It Works
Penni connects to your QuickBooks Online account through a secure API. Your data lives in YOUR QuickBooks — not on our servers. If you stop using Penni, your books are exactly where they've always been.
API Key
You can also set your API key via environment variable:
PENNI_API_KEY=your_key_here npx penni-mcpOr pass it as a flag:
npx penni-mcp --key your_key_hereThe key is saved to ~/.penni/config.json after first run.
Links
Website: penni.so
Dashboard: app.penni.so
Support: support@penni.so
License
MIT
Available Tools
6 toolspenni_askA
Ask Penni a bookkeeping question about your QuickBooks data
Inputs: question (required).
penni_create_expenseB
Create an expense entry in QuickBooks (requires Penni subscription)
Inputs: vendor (required), amount (required), category (required), date, +1 more.
penni_create_invoiceB
Create and optionally send an invoice through QuickBooks (requires Penni subscription)
Inputs: customer_name (required), line_items (required), due_date (required), send.
penni_get_balanceB
Get current bank account balances from QuickBooks
Inputs: no named parameters.
penni_get_invoicesA
Get open and overdue invoices from QuickBooks
Inputs: no named parameters.
penni_get_pnlB
Get Profit & Loss report from QuickBooks
Inputs: start_date, end_date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: asking questions, creating expenses, creating invoices, getting bank balances, listing invoices, and getting profit & loss reports. No overlap or ambiguity.
All tools follow a consistent 'penni_verb_noun' pattern using snake_case (e.g., penni_ask, penni_create_expense, penni_get_balance). Perfectly predictable.
With 6 tools covering core bookkeeping operations (read, create, list, report), the count feels well-scoped for a specialized MCP server without being too few or too many.
The tool surface covers essential bookkeeping tasks (query, create expense/invoice, get balances, list invoices, P&L). Missing update/delete operations for expenses and invoices, but the core workflows are covered.
Maintenance
Related MCP Connectors
Connect Claude or Cursor to books, invoices, bills, payroll, and sealed closes.
Query your books, company data, business health, and ship invoices from your AI assistant.
QuickBooks Online in Claude and ChatGPT: 221 tools, full ledger, multi-company, Canada + US, FR/EN.
Your books in your AI assistant: draft expenses, bills, invoices, estimates; ask about P&L, tax.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to query and manage QuickBooks Online data through natural language, including customers, invoices, bills, vendors, accounts, and financial reports.7MIT
- AlicenseNot gradedqualityDmaintenanceConnect Claude Desktop and Claude Code to QuickBooks Online for natural-language accounting. Ask questions about invoices, expenses, reports, and more using plain English.MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to QuickBooks Online, enabling management of invoices, customers, expenses, and reports through natural language.MIT
- AlicenseAqualityBmaintenanceEnables financial professionals to interact with QuickBooks Online using natural language for reports, journal entries, bills, expenses, and more.36245 npm13MIT