Zoho Books MCP Server
Official Zoho Books MCP server for AI agents: manage invoices, contacts, bills, expenses, items, and pull financial reports through OAuth-secured endpoints.
Zoho Books MCP is the official Model Context Protocol server from Zoho that lets AI agents read from and act on a Zoho Books organization. It is part of the broader Zoho MCP platform (zoho.com/mcp), which exposes Zoho apps including Books, CRM, Desk, Projects, Billing, and Expense as agent-ready endpoints via OAuth-secured remote MCP servers.
The Books connector exposes core accounting workflows: creating and listing invoices, managing customers and vendors, recording expenses and bills, querying items, retrieving organization details, and pulling financial reports such as profit and loss statements and balance sheets. Access is gated by the user's existing Zoho permission structure, so an agent cannot perform actions the connected user is not authorized to do.
There are two ways to use it. The quickest is the built-in Claude Connector (Settings, Connectors, search for Zoho Books) which gives you a curated subset of actions. For full tool coverage and use with Cursor, ChatGPT, or other MCP clients, you create a server in the Zoho MCP Hub, pick the Books tools you want to expose, and connect via a generated server URL. Several community implementations also exist on GitHub, but this entry covers the provider-hosted official server.
Tools
| Tool | Description |
|---|---|
list_invoices |
List invoices in the connected Zoho Books organization, with filters for status and date. |
create_invoice |
Create a new customer invoice with line items. |
get_invoice |
Retrieve a specific invoice by ID. |
list_contacts |
List customers and vendors stored in Zoho Books. |
create_contact |
Add a new customer or vendor contact. |
get_contact |
Retrieve a contact's details by ID. |
list_bills |
List vendor bills in the organization. |
create_bill |
Record a new vendor bill with line items. |
list_expenses |
List recorded expenses. |
create_expense |
Record a new expense against an account. |
list_items |
List products and services configured in Books. |
get_organization |
Retrieve details about the connected Zoho Books organization. |
get_profit_and_loss |
Pull a profit and loss report for a given period. |
get_balance_sheet |
Pull a balance sheet report as of a given date. |
Prerequisites
- An active Zoho Books organization with admin rights
- Your Zoho Organization Name and Organization ID
- An MCP client (Claude Desktop, Claude.ai web, Cursor, ChatGPT, or similar)
Option 1: Claude Connector (fastest)
- In Claude, open Settings, then Connectors.
- Search for "Zoho Books" and click Connect.
- Complete the Zoho OAuth flow (use accounts.zoho.in for India DC accounts).
- In a new chat, enable the Zoho Books toggle.
Note: the default connector exposes a limited action set. Use Option 2 for full tool coverage.
Option 2: Zoho MCP Hub (full access)
- Go to https://www.zoho.com/mcp/ and create a new MCP server.
- Select Zoho Books as a source and pick which tools to expose.
- Choose an authorization model: "Authorization on Demand" (per-user OAuth) or "Authorization via Connections" (Super Admin shares tokens).
- Copy the generated MCP Server URL (it embeds a secure API key, treat it like a password).
Claude Desktop config
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"zoho-books": {
"type": "url",
"url": "https://claude-zohobooks.zohomcp.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ZOHO_ACCESS_TOKEN"
}
}
}
}
Or use the Claude CLI:
claude mcp add zoho-books \
--transport http \
--url https://claude-zohobooks.zohomcp.com/mcp \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
Notes on tokens
- Access tokens expire after 1 hour; use refresh tokens to renew.
- Required OAuth scopes cover invoices, contacts, bills, expenses, items, settings, and reports.
- India DC users must use
https://accounts.zoho.in/oauth/v2/tokeninstead ofaccounts.zoho.com.
- Draft and send customer invoices from natural language ("invoice Acme for 10 hours of consulting at $150/hr, net 30") without leaving the chat interface.
- Pull a profit and loss statement for last quarter and have the agent summarize variances vs the prior quarter.
- Bulk-create new customer or vendor contacts in Zoho Books from a list pasted into the chat.
- Record expenses against the right account from a forwarded receipt email, then reconcile against the bank feed.
- Triage overdue invoices by listing all unpaid invoices past due date and drafting follow-up notes per customer.
- "Create an invoice for customer Acme Corp with one line item: 10 hours of consulting at $150/hour, due in 30 days."
- "List all unpaid invoices that are more than 14 days overdue and group them by customer."
- "Add a new vendor called Stripe with email billing@stripe.com to Zoho Books."
- "Pull our profit and loss report for Q1 2026 and tell me which expense category grew the most vs Q4 2025."
- "Record an expense of $480 on 2026-05-12 against the 'Software Subscriptions' account with description 'Figma annual renewal'."
- Official and maintained by Zoho, not a community fork, with OAuth2 security and audit trails.
- Provider-hosted: no Docker, no Python env, no local server to babysit.
- Respects existing Zoho user permissions so agents inherit the connected user's access scope.
- Works alongside other Zoho MCP servers (CRM, Desk, Projects) for cross-app workflows.
- The default Claude Connector exposes a limited action set; full tool coverage requires building a custom server in the Zoho MCP Hub.
- India DC accounts require special OAuth endpoints (accounts.zoho.in), an easy footgun during setup.
- Tool list is not published as a formal schema in public docs; capabilities are documented at the feature level rather than per tool name.
- QuickBooks MCP community servers for QuickBooks Online users.
- Xero MCP community implementations for Xero accounting.
- CData Zoho Books MCP Server: a read-only self-hosted MCP server over CData JDBC drivers, useful if you need SQL-style querying of Books data.