Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Zoho Books con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA trabaje en Zoho Books: busca y gestiona clientes, proveedores y artículos, crea, envía por correo, marca como enviadas y anula facturas, crea presupuestos, registra pagos de clientes, facturas de proveedores y gastos, y consulta el plan de cuentas, los mayores de cuentas y las transacciones bancarias. Cualquier centro de datos de Zoho, inicio de sesión con OAuth de Zoho.
Prueba a pedir
Prompts de ejemplo para Zoho Books
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Zoho Books, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Zoho Books
Deja que tu IA trabaje en Zoho Books: busca y gestiona clientes, proveedores y artículos, crea, envía por correo, marca como enviadas y anula facturas, crea presupuestos, registra pagos de clientes, facturas de proveedores y gastos, y consulta el plan de cuentas, los mayores de cuentas y las transacciones bancarias. Cualquier centro de datos de Zoho, inicio de sesión con OAuth de Zoho.
Configuración
- Averigua tu centro de datos de Zoho: aparece en la barra de direcciones cuando usas Zoho Books (por ejemplo books.zoho.eu o books.zoho.com). Pon en
ZOHO_BOOKS_ACCOUNTS_URLyZOHO_BOOKS_API_URLese centro de datos, sin barra final:https://accounts.zoho.euyhttps://www.zohoapis.eupara la UE,https://accounts.zoho.comyhttps://www.zohoapis.compara EE. UU. India, Australia, Japón, Arabia Saudí, los Emiratos Árabes Unidos y China siguen el mismo patrón (.in,.com.au,.jp,.sa,.ae,.com.cn); Canadá usahttps://accounts.zohocloud.cayhttps://www.zohoapis.ca. - Abre la Zoho API Console en api-console.zoho.com, con la sesión de tu cuenta de Zoho, y elige Add Client → Server-based Applications.
- Ponle un nombre al cliente (por ejemplo AnythingMCP), la web de tu empresa como homepage URL y
https://cloud.anythingmcp.com/api/mcp-oauth/callbackcomo Authorized Redirect URI. Si alojas AnythingMCP tú mismo, introduce en su lugarhttps://tu-host-anythingmcp/api/mcp-oauth/callback. Crea el cliente. - En la pestaña Client Secret, copia el Client ID (empieza por
1000.) y el Client Secret enZOHO_BOOKS_CLIENT_IDyZOHO_BOOKS_CLIENT_SECRET. Si tu organización de Books está en otro centro de datos distinto del que abrió la consola, activa ese centro de datos en la pestaña Settings del cliente (Multi-DC) y usa el client secret que aparece allí. - Busca el ID de la organización: en Zoho Books, haz clic en el nombre de la organización (arriba a la derecha) y abre Manage Organizations; el ID aparece junto a cada organización. Pega los dígitos en
ZOHO_BOOKS_ORGANIZATION_ID. Un conector trabaja con una sola organización; para una segunda, vuelve a instalarlo. - Instala el conector, haz clic en Authorize with Provider en la página del conector, inicia sesión en Zoho y aprueba el acceso solicitado.
- Ejecuta
zoho_books_list_organizationsy comprueba que tu ID de organización aparece en la lista, y luegozoho_books_get_organizationpara confirmar el nombre y la moneda base antes de que la IA lea o escriba nada.
Mantener la sesión iniciada: los access tokens duran una hora y se renuevan automáticamente con el refresh token guardado, que no caduca salvo que se revoque. Zoho guarda como máximo 20 refresh tokens por usuario y cliente: autorizar el mismo cliente por 21.ª vez, en AnythingMCP o en otro sitio, revoca sin aviso el más antiguo. Si el conector pierde la sesión, vuelve a hacer clic en Authorize with Provider.
Permisos y solo lectura: el conector pide 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. Los artículos, los impuestos y los ajustes de la organización dependen de ZohoBooks.settings, el plan de cuentas de ZohoBooks.accountants. Trabaja como el usuario de Zoho que lo autorizó, dentro de su rol. Para una configuración de solo lectura, cambia cada .ALL por .READ en los ajustes OAuth del conector, vuelve a autorizar y desactiva 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 y zoho_books_create_expense.
Desactivadas al instalar: las herramientas de borrado zoho_books_delete_contact, zoho_books_delete_invoice, zoho_books_delete_estimate, zoho_books_delete_customer_payment, zoho_books_delete_bill y zoho_books_delete_expense. Un registro eliminado no se puede recuperar, así que activa una solo si la IA debe borrar de verdad ese tipo de registro.
Las escrituras son reales: zoho_books_email_invoice envía un correo al cliente desde tu organización, zoho_books_mark_invoice_sent y zoho_books_void_invoice cambian la contabilidad, y zoho_books_create_customer_payment, zoho_books_create_bill y zoho_books_create_expense se contabilizan en el libro mayor. La IA dice antes qué va a contabilizar o enviar y espera tu sí. Registrar un pago de cliente es solo contabilidad: no se cobra dinero.
Facturas y correcciones: una factura nueva es un borrador con el siguiente número de la numeración automática de tu organización, y solo se envía por correo si pides que salga en el momento. Zoho no permite eliminar una factura enviada: anúlala con zoho_books_void_invoice. Una factura anulada queda registrada, como exigen normas contables como la GoBD alemana, y zoho_books_mark_invoice_draft la convierte de nuevo en un borrador editable para corregirla y volver a emitirla.
Totales y saldos: Zoho no documenta una API de informes para Books. Para los totales, la IA lee los saldos del plan de cuentas, los movimientos de una cuenta con zoho_books_list_account_transactions o listas filtradas por fecha.
Límites: 100 solicitudes por minuto y organización y, al día, 1.000 en Free, 2.000 en Standard, 5.000 en Professional y 10.000 a partir de Premium. Por encima del límite Zoho responde 429 (código 44 por minuto, 45 por día): espera un minuto o hasta el día siguiente.
Errores frecuentes: invalid_client al iniciar sesión o una lista de organizaciones vacía significa que las dos URL no son las de tu centro de datos. 401 con código 57 ("You are not authorized to perform this operation") o invalid_oauthtoken significa que al inicio de sesión le falta un scope, que se revocó o que ZOHO_BOOKS_API_URL es el centro de datos equivocado: revisa ambas URL y vuelve a hacer clic en Authorize with Provider. 400 o 404 que mencionan la organización significa que ZOHO_BOOKS_ORGANIZATION_ID es incorrecto o no es visible para este usuario: compáralo con zoho_books_list_organizations. Los demás errores 400 indican el campo (un nombre duplicado, un valor no válido, un campo obligatorio que falta). El código 4529 significa que una factura enviada no se puede eliminar: anúlala. El código 3000 al eliminar un contacto significa que aún hay facturas o pagos que lo usan: usa zoho_books_mark_contact_inactive.
El conector no gestiona pedidos de venta, órdenes de compra, notas de crédito, pagos a proveedores, asientos manuales, proyectos, facturas recurrentes, adjuntos ni PDF.
Requisitos previos: ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Zoho Books e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Qué facturas están vencidas y cuánto nos debe todavía cada cliente?"
- "Muéstrame el saldo de nuestra cuenta de gastos Material de oficina y todos sus movimientos de septiembre."
- "Crea un borrador de factura para Acme S.L.: 12 horas de Consultoría a 95 EUR, con vencimiento a 14 días. No la envíes todavía."
- "Registra la transferencia de hoy de 1.140 EUR de Acme S.L. como pago de la factura INV-000123."
Siguientes pasos
¿Te ha sido útil esta guía?
