跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Zoho Books，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 在 Zoho Books 中工作：查找和管理客户、供应商和商品，创建发票、通过邮件发送、标记为已发送和作废，创建报价单，记录客户付款、供应商账单和费用，并读取科目表、科目明细账和银行交易。支持任意 Zoho 数据中心，使用 Zoho OAuth 登录。
试试这样问
Zoho Books 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Zoho Books、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Zoho Books
让你的 AI 在 Zoho Books 中工作：查找和管理客户、供应商和商品，创建发票、通过邮件发送、标记为已发送和作废，创建报价单，记录客户付款、供应商账单和费用，并读取科目表、科目明细账和银行交易。支持任意 Zoho 数据中心，使用 Zoho OAuth 登录。
设置
- 确认你的 Zoho 数据中心：使用 Zoho Books 时，地址栏里就能看到（例如 books.zoho.eu 或 books.zoho.com）。把
ZOHO_BOOKS_ACCOUNTS_URL和ZOHO_BOOKS_API_URL设为该数据中心的地址，末尾不要加斜杠：欧盟为https://accounts.zoho.eu和https://www.zohoapis.eu，美国为https://accounts.zoho.com和https://www.zohoapis.com。印度、澳大利亚、日本、沙特阿拉伯、阿联酋和中国遵循同样的规则（.in、.com.au、.jp、.sa、.ae、.com.cn）；加拿大使用https://accounts.zohocloud.ca和https://www.zohoapis.ca。 - 用你的 Zoho 账户登录，打开 Zoho API Console（api-console.zoho.com），选择 Add Client → Server-based Applications。
- 为客户端命名（例如 AnythingMCP），homepage URL 填你公司的网站，Authorized Redirect URI 填
https://cloud.anythingmcp.com/api/mcp-oauth/callback。如果你自行托管 AnythingMCP，则改为填写https://your-anythingmcp-host/api/mcp-oauth/callback。创建客户端。 - 在 Client Secret 选项卡中，把 Client ID（以
1000.开头）和 Client Secret 分别复制到ZOHO_BOOKS_CLIENT_ID和ZOHO_BOOKS_CLIENT_SECRET。如果你的 Books 组织位于与控制台打开时不同的数据中心，请在客户端的 Settings 选项卡（Multi-DC）中启用该数据中心，并使用那里显示的 client secret。 - 找到组织 ID：在 Zoho Books 中点击右上角的组织名称，打开 Manage Organizations，每个组织旁边都会显示 ID。把这串数字填入
ZOHO_BOOKS_ORGANIZATION_ID。一个连接器只对应一个组织；如需第二个组织，请再安装一次。 - 安装连接器，在连接器页面点击 Authorize with Provider，登录 Zoho 并批准所请求的访问权限。
- 运行
zoho_books_list_organizations，确认列表中有你的组织 ID，然后运行zoho_books_get_organization核对组织名称和本位币，再让 AI 读取或写入任何内容。
保持登录状态：访问令牌有效期为一小时，会用保存的刷新令牌自动续期；刷新令牌只要不被撤销就不会过期。Zoho 每个用户和客户端最多保留 20 个刷新令牌：第 21 次授权同一个客户端时，无论在 AnythingMCP 还是别处，最旧的那个都会被悄悄撤销。如果连接器失去登录状态，请再次点击 Authorize with Provider。
权限和只读设置：连接器请求 ZohoBooks.settings.ALL, ZohoBooks.contacts.ALL, ZohoBooks.invoices.ALL, ZohoBooks.estimates.ALL, ZohoBooks.customerpayments.ALL, ZohoBooks.bills.ALL, ZohoBooks.expenses.ALL, ZohoBooks.accountants.READ, ZohoBooks.banking.READ。商品、税和组织设置属于 ZohoBooks.settings，科目表属于 ZohoBooks.accountants。连接器以授权它的 Zoho 用户身份工作，权限以该用户的角色为限。如需只读设置，请在连接器的 OAuth 设置中把每个 .ALL 改为 .READ，重新授权，并关闭 zoho_books_create_contact、zoho_books_update_contact、zoho_books_mark_contact_inactive、zoho_books_create_item、zoho_books_update_item、zoho_books_mark_item_inactive、zoho_books_create_invoice、zoho_books_email_invoice、zoho_books_mark_invoice_sent、zoho_books_void_invoice、zoho_books_mark_invoice_draft、zoho_books_create_estimate、zoho_books_create_customer_payment、zoho_books_create_bill 和 zoho_books_create_expense。
安装时默认关闭：删除工具 zoho_books_delete_contact、zoho_books_delete_invoice、zoho_books_delete_estimate、zoho_books_delete_customer_payment、zoho_books_delete_bill 和 zoho_books_delete_expense。删除的记录无法恢复，所以只有在 AI 确实需要删除这类记录时才打开对应工具。
写入是真实生效的：zoho_books_email_invoice 会以你组织的名义给客户发邮件，zoho_books_mark_invoice_sent 和 zoho_books_void_invoice 会改变账簿，zoho_books_create_customer_payment、zoho_books_create_bill 和 zoho_books_create_expense 会过账到总账。AI 会先说明要记账或发送的内容，等你确认后再执行。记录客户付款只是记账，不会实际收款。
发票和更正：新发票是一张草稿，编号来自你组织的自动编号，只有在你要求立即发出时才会通过邮件发送。Zoho 不允许删除已发送的发票：请改用 zoho_books_void_invoice 作废。作废的发票会保留在记录中，这正是德国 GoBD 等记账规则所要求的；zoho_books_mark_invoice_draft 可以把它变回可编辑的草稿，以便更正后重新开具。
合计和余额：Zoho 没有为 Books 提供文档化的报表 API。需要合计时，AI 会读取科目表中的余额、用 zoho_books_list_account_transactions 读取某个科目的交易，或者读取按日期筛选的列表。
限制：每个组织每分钟 100 个请求；每天的上限为 Free 版 1,000 个、Standard 版 2,000 个、Professional 版 5,000 个、Premium 及以上 10,000 个。超出限制时 Zoho 返回 429（每分钟限制为代码 44，每日限制为代码 45）：请等一分钟，或等到第二天。
常见错误：登录时出现 invalid_client 或组织列表为空，表示这两个 URL 不是你的数据中心。401 代码 57（"You are not authorized to perform this operation"）或 invalid_oauthtoken 表示登录缺少某个权限范围、已被撤销，或者 ZOHO_BOOKS_API_URL 的数据中心不对：请检查两个 URL，然后再次点击 Authorize with Provider。提到组织的 400 或 404 表示 ZOHO_BOOKS_ORGANIZATION_ID 有误，或者该用户看不到这个组织：请与 zoho_books_list_organizations 的结果对照。其他 400 错误会指出具体字段（名称重复、值无效、缺少必填字段）。代码 4529 表示已发送的发票不能删除：请作废它。删除联系人时出现代码 3000 表示仍有发票或付款引用它：请使用 zoho_books_mark_contact_inactive。
该连接器不处理销售订单、采购订单、贷项通知单、供应商付款、日记账、项目、定期发票、附件或 PDF。
前提条件: ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 Zoho Books 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
zoho_books_list_organizations | List the Zoho Books organizations this sign-in can reach: organization_id, name, country, currency, time zone and whether it is the default |
zoho_books_get_organization | Read the connected organization: name, address, base currency, fiscal year start, time zone, tax settings and contact details |
zoho_books_list_contacts | List contacts (customers and vendors) with contact_id, name, company, email, status and outstanding receivables or payables |
zoho_books_get_contact | Read one contact with addresses, contact persons, payment terms, currency, balances and custom fields |
zoho_books_create_contact | Create a customer or vendor |
zoho_books_update_contact | Update a contact |
zoho_books_mark_contact_inactive | Mark a contact inactive: it stays in the books but is hidden from lists and cannot be used on new transactions |
zoho_books_delete_contact | Delete a contact for good |
zoho_books_list_items | List items (products and services) with item_id, name, SKU, rate, unit, tax and status |
zoho_books_get_item | Read one item with selling and purchase prices, accounts, tax, unit and stock details |
zoho_books_create_item | Create an item (product or service) |
zoho_books_update_item | Update an item |
zoho_books_mark_item_inactive | Mark an item inactive so it can no longer be added to new documents |
zoho_books_list_invoices | List invoices with invoice_id, number, customer, status, date, due date, total and balance |
zoho_books_get_invoice | Read one invoice with line items, taxes, totals, balance, payments, customer and status |
zoho_books_create_invoice | Create an invoice (a draft, unless send is true, which also emails it to the customer: confirm that with the user first) |
zoho_books_email_invoice | Email an invoice to the customer from the organization, with the invoice attached |
zoho_books_mark_invoice_sent | Mark a draft invoice as sent without emailing it (for invoices delivered another way) |
zoho_books_void_invoice | Void an invoice: it stays on record with status void but no longer counts as receivable or revenue |
zoho_books_mark_invoice_draft | Turn a void invoice back into a draft, for example to correct and reissue it |
zoho_books_delete_invoice | Delete an invoice for good: only a draft without recorded payments |
zoho_books_list_estimates | List estimates (quotes) with estimate_id, number, customer, status, date, expiry date and total |
zoho_books_get_estimate | Read one estimate with line items, taxes, totals and status |
zoho_books_create_estimate | Create an estimate (quote) as a draft |
zoho_books_delete_estimate | Delete an estimate (quote) for good; it cannot be restored |
zoho_books_list_customer_payments | List payments received from customers with payment_id, customer, date, amount, payment mode and the invoices they paid |
zoho_books_get_customer_payment | Read one customer payment with the invoices it was applied to |
zoho_books_create_customer_payment | Record a payment received from a customer and apply it to invoices (bookkeeping only; no money is collected) |
zoho_books_delete_customer_payment | Delete a recorded customer payment; the invoices become unpaid again |
zoho_books_list_bills | List bills (vendor invoices) with bill_id, number, vendor, status, date, due date, total and balance |
zoho_books_get_bill | Read one bill with line items, accounts, taxes, totals, balance and payments |
zoho_books_create_bill | Record a bill received from a vendor (it posts to the ledger as payable) |
zoho_books_delete_bill | Delete a bill for good (only without recorded payments) |
zoho_books_list_expenses | List expenses with expense_id, date, account, amount, vendor, customer and status (billable, invoiced, ...) |
zoho_books_get_expense | Read one expense with account, paid-through account, tax, vendor, customer and receipts |
zoho_books_create_expense | Record an expense paid from a bank, cash or credit card account (it posts to the ledger) |
zoho_books_delete_expense | Delete an expense for good; its ledger postings are removed |
zoho_books_list_chart_of_accounts | List the chart of accounts: account_id, name, code, type (asset, liability, equity, income, expense, bank, cash, ...), active flag and… |
zoho_books_get_account | Read one account of the chart of accounts: name, code, type, currency, description and balance |
zoho_books_list_account_transactions | List the transactions booked on one account (invoices, payments, bills, expenses, journals) with date, debit, credit and reference: a… |
zoho_books_list_bank_accounts | List bank, cash and credit card accounts with account_id, name, type, currency, balance and bank name |
zoho_books_get_bank_account | Read one bank or credit card account with balance and bank details |
zoho_books_list_bank_transactions | List bank transactions (deposits, withdrawals, transfers and feed lines) with date, amount, type, status (categorized, uncategorized… |
zoho_books_get_bank_transaction | Read one bank transaction with its accounts, amounts and the documents it is matched to |
zoho_books_list_taxes | List the organization's taxes and tax groups with tax_id, name, percentage and type, for line items and expenses |
示例提示
- “哪些发票已经逾期？每位客户还欠我们多少钱？”
- “显示我们“办公用品”费用科目的余额，以及 9 月份该科目上的所有记账。”
- “为 Acme Ltd 创建一张发票草稿：12 小时“咨询”服务，单价 95 EUR，14 天后到期。先不要发送。”
- “把 Acme Ltd 今天转来的 1,140 EUR 记录为发票 INV-000123 的付款。”
下一步
这份指南对你有帮助吗?
