Set Up MCP For Zoho Billing

Model Context Protocol (MCP) is an open protocol that standardizes how applications communicate with Large Language Models (LLMs). The Zoho MCP server uses this protocol to connect your Zoho Billing data and workflows directly to AI agents such as Claude and ChatGPT.

Once connected, you can create invoices, track payments, manage customers, and pull reports; all through plain-language prompts in your AI agent’s interface, without having to navigate to Zoho Billing manually.

Scenario: Patricia Boyle, Finance Manager at Zylker Technologies, spends hours each week chasing overdue invoices and generating aging reports. Using the Zoho Billing MCP server connected to Claude, she simply prompts, "In Org Zylker Technologies (ID: [Org ID]), list all customers with invoices overdue by 30 days" and the results are back instantly. She spots the high-value accounts that need attention, loops in her collections team, and wraps up in minutes what used to take half her morning.

How Zoho MCP Works

The Zoho MCP server acts as a secure bridge between your AI agent and your Zoho Billing organization. When you prompt your AI agent (the MCP client), it processes the request through the MCP server, which then calls the Zoho Billing API to carry out the action.

Note: The Zoho Billing API is the underlying interface through which all tool actions are executed. When a prompt is processed, the AI agent translates it into an API request and calls the Zoho Billing API on your behalf. This means every action your AI agent performs is subject to API limits, permissions, and audit logs.

Before you get started, here are the key components you’ll encounter:

Component	Role
MCP Server	The configured server that exposes a set of tools AI agent such as Create Invoice, Get Contact Person, or Update Subscription to your AI agent.
MCP Client	The AI agent (Claude, Cursor, Windsurf, etc.) that receives and processes your prompts.
Tools	The specific actions your AI agent is permitted to perform in Zoho Billing. You select tools from the available list in Zoho MCP.
You	Provide natural-language instructions; the AI agent calls the right tool on your behalf.

Here is the lifecycle of an action:

You type a prompt in your AI agent’s interface for example, “In [Org ID], create an invoice for Zylker Corp for $500.”
The AI agent identifies the right tool from the enabled tools on your MCP server.
The AI agent sends the request to the Zoho MCP server.
The MCP server calls the Zoho Billing API to carry out the action.
The action is executed in your Zoho Billing account in this case, an invoice is created for Zylker Corp.

Supported MCP Clients

Zoho MCP works with any MCP-compatible client. The following clients have dedicated setup guides:

In addition to Claude and ChatGPT, Zoho MCP is compatible with Cursor, Windsurf, VS Code (with GitHub Copilot in Agent mode), Zed, Continue, Cline, and n8n. Learn More

Prerequisites

Before setting up an MCP server, ensure the following are in place:

Permissions:
- To connect Zoho MCP with Claude, you must be a Claude Organization Admin. Once connected, the integration is automatically accessible to all members of your Claude organization. This applies only if you are on the Claude Team plan or higher.
- For all other MCP clients (Cursor, Windsurf, VS Code, etc.), account-level access to your Zoho Billing organization is sufficient.
MCP client installed: Make sure your preferred AI agent such as Claude or ChatGPT is set up and ready to use.

Set Up Your MCP Server

Setting up your MCP server is the foundation of your Zoho MCP configuration. Only after your server is configured can your AI agent connect to it and begin executing actions in Zoho Billing through the tools you have enabled.

Note: AI agents can sometimes misinterpret prompts or make mistakes. Always review the actions your AI agent performs before treating them as final. We recommend testing in your sandbox environment before going live. Reach out to us at support@zohobilling.com if you need any help.

Generate Your Server URL

Log in to Zoho MCP using your Zoho Billing account credentials.
Create or select an MCP server.
Go to Connect in the left sidebar.
Copy the Server URL shown on the page.

Your Server URL follows this format:

https://[mcp-server-name]-[org-id].zohomcp.com/mcp/[api-key]/message

Warning:

Treat your Server URL like a password. It grants access to your Zoho Billing tools and data, anyone with this URL can use it to interact with your MCP server. Do not share it in public repositories, shared documents, or anywhere others can view it. If you suspect your Server URL has been compromised, (regenerate it immediately)[#regenerate-your-api-key].

Regenerate Your API Key

If your Server URL is ever exposed or compromised, you can regenerate a new API key. This invalidates the old URL immediately, and any MCP clients using the old URL will lose access.

Go to Connect in the left sidebar.
Click Regenerate API Key at the top right of the Server URL section.
Copy the new Server URL and update it in all connected MCP clients.

Note: Regenerating the API key disconnects all existing MCP client integrations. You'll need to reconfigure each client with the new URL.

Configure Tools in Zoho MCP

Tools are the building blocks of everything your AI agent can do in Zoho Billing. When you connect an AI agent to Zoho Billing through the MCP server, the AI agent doesn’t automatically get access to every action in Zoho Billing. Instead, you choose exactly which actions the AI agent is permitted to perform. These permitted actions are called tools. Each tool maps to a specific Zoho Billing API call when an AI agent executes a tool, it triggers the corresponding API in the background to carry out the action on your Zoho Billing data.

Scenario: Patricia Boyle, Finance Manager at Zylker Technologies, wants to use Claude to pull overdue invoices and modify their data, but she doesn't want the AI agent to have the ability to modify subscription plans or delete records. By enabling only the Get Invoice, Update Invoice,and List Invoice tools in Zoho MCP, she ensures Claude can assist with exactly those tasks and nothing beyond them.

Here’s how you can manage your tools:

View Available Tools

When your AI agent sends a prompt for example, “List all overdue invoices” the MCP server interprets that request and uses the enabled tools to carry out the action in Zoho Billing. Only tools that are enabled on your MCP server are recognized and available to your AI agent.

Log in to Zoho MCP account.
Select the MCP server for which you’d like to view the tools.
Go to Tools in the left sidebar.

The tools listed here reflect what you’ve enabled for your MCP server. Click Add More Tools at the top right to browse and enable additional tools.

Delete Tools in Zoho MCP

You can control which tools are exposed to your AI agent from the Tools page. Deleting a tool removes it from your MCP server, and your AI agent will no longer be able to call that tool.

Log in to Zoho MCP account.
Select the MCP server for which you’d like to manage tools.
Go to Tools in the left sidebar.
Click the More icon next to the tool you want to remove and click Delete.

The tool will be removed from your MCP server and will no longer be accessible to your AI agent.

Understand Tool Permissions

Each tool in Zoho MCP maps directly to an action in Zoho Billing. When an AI agent calls a tool, it uses the authorization linked to your MCP server. You can configure the authorization type from the Connections section.

Learn more about managing your connections in Zoho MCP.

Connect with an MCP Client

With your MCP server set up, the next step is connecting it to your AI agent. This allows your AI agent to receive prompts and execute actions in Zoho Billing through the tools you have enabled.

Connect with Claude

Go to claude.ai/settings/connectors, or open the Claude desktop application.
Go to Settings, and click Connectors.
Click Add Custom Connector at the bottom.
Enter a name for your connector for example, Zoho Billing.
Paste the Server URL from Zoho MCP in the URL field and click Save.
Scroll down to the connector you created and click Connect.

Note: During the connection setup, you will encounter two authorization screens. The first requests access to your Zoho MCP account and the tools you have enabled. The second is a Zoho OAuth screen that lists the specific Zoho Billing permissions being requested. Review the permissions on both screens and click Allow, then Accept, to complete the authorization.

Once authorized, the connector will be active and Claude can begin executing actions in Zoho Billing on your behalf.

Access Zoho MCP Tools in Claude

Open a new chat in Claude.
Click the + icon in the chat toolbar and click Connectors.
Select the custom connector you created.
Start prompting Claude to manage your Zoho Billing data.

Note: Each time you add a new tool in your MCP server, disconnect your custom connector in Claude and reconnect. You'll need to grant the required permissions to proceed.

Connect with ChatGPT

Note: Connecting Zoho MCP with ChatGPT requires a ChatGPT Plus, Pro, or Team plan. This feature is not available on the free tier.

ChatGPT supports MCP-based integrations through custom apps, allowing you to connect it to your Zoho MCP server and perform actions in Zoho Billing directly from your ChatGPT conversations.

First, copy your MCP URL from Zoho MCP:

Log in to Zoho MCP account.
Create or select your MCP server.
Configure the tools as required.
Go to Connect in the left sidebar.
Copy the MCP URL.

Next, create a custom app in ChatGPT:

Log in to your ChatGPT account.
Click your profile icon and click Settings.
Go to the Apps tab and scroll down to Advanced Settings.
Toggle Developer Mode and click Create App.

Note: Developer Mode is a ChatGPT setting that allows you to connect external tools and services such as Zoho MCP to your ChatGPT account using custom apps.

In the New App page, enter a name for your connector in the Name field.
Paste the MCP URL copied from Zoho MCP in the MCP Server URL field.
Set Authentication to OAuth.
Read the terms, check I trust this application, and click Create.

Note:

During the connection setup, you will encounter two authorization screens. The first requests access to your Zoho MCP account and the tools you have enabled. The second is a Zoho OAuth screen that lists the specific Zoho Billing permissions being requested. Review the permissions on both screens and click Allow, then Accept, to complete the authorization.

Your connection will be created and you can then use ChatGPT to perform actions in your Zoho Billing account.

Access Zoho MCP Tools in ChatGPT

Here’s how you can start using the tools to perform actions from ChatGPT:

Open a new chat in ChatGPT.
Click the + icon in the chat toolbar.
Click More and select the app you created.
Start prompting ChatGPT to manage your Zoho Billing data.

Note: Each time you add a new tool in your MCP server, refresh your custom connector in ChatGPT and grant the required permissions to proceed. If you run into any issues, write to us at support@zohobilling.com. Our support team will help you resolve the issue.

Write Effective Prompts

Your prompt is the instruction your AI agent works from the clearer it is, the less back-and-forth you’ll need. A well-structured prompt gets the right action done on the right record the first time.

Keep these tips in mind:

Name things specifically. Use the exact field names, IDs, and module names as they appear in Zoho Billing.
Reference records by their unique IDs so there’s no ambiguity about which customer, invoice, or plan you mean.
State your intent clearly what you want done, to what, and under what conditions.
Include edge cases upfront. If something should only happen when a condition is met, say so.

Scenario:

Johan, a Sales Operations Manager at Zylker Technologies, used to manually cross-check closed deals in Zoho CRM against subscription records in Zoho Billing at the end of every month a process that took hours and left room for mismatches. Now, using Zoho MCP, he simply prompts his AI agent: “In [Org Name] (Org ID), fetch the list of deals closed in Zoho CRM this month and show me their corresponding subscription status in Zoho Billing.” In seconds, he has a complete view, spots a converted lead without an active subscription, and creates one on the spot.

Here are some example prompts to help you get started with common billing workflows. Adapt them with your actual customer names, amounts, and plan details.

Handle Invoices

In [Org Name] (Org ID), create an invoice for Zylker Corp with three items Professional Services at $500, Support at $200, and Setup at $100.
In [Org Name] (Org ID), collect payment for John’s invoice using his saved bank account.

Manage Subscriptions

In [Org Name] (Org ID), set up a new subscription for Zylker Corp on the Growth plan.
In [Org Name] (Org ID), update the offer amount of the coupon SUMMER20 to $25.

Pull Reports

In [Org Name] (Org ID), get the ARR report for Q1 2025 and summarize the month-on-month trend.
In [Org Name] (Org ID), get the AR aging summary report for January and list all customers with outstanding invoices, bucketed by how overdue they are.

Create Quotes and Plans

In [Org Name] (Org ID), create a quote for Acme Corp for Professional Services, Support, and Onboarding.
In [Org Name] (Org ID), create a new plan called Business Pro, billed monthly at $99.

Record Payments

In [Org Name] (Org ID), record a payment of $500 from Zylker Corp against their latest invoice.
In [Org Name] (Org ID), create a payment link for Sarah for her outstanding invoice.

Note:

The prompts above cover only a handful of the available tools. To see the full list, log in to Zoho MCP and go to Tools.

Pro Tip: When working in Claude, select only the tools you need for the current task before starting a chat. This keeps the AI focused and reduces the chance of unintended actions.

Track Your Activity Using Logs

Every time your AI agent performs an action in Zoho Billing through the MCP server whether it creates an invoice, retrieves a customer record, or applies a coupon that action is logged. The Logs page gives you a complete, searchable record of all tool calls made through your MCP server, along with their outcomes.

Scenario: Aaron Brown, Finance Manager at Zylker, notices that several invoices were created with incorrect line items over the past two days. Rather than manually tracing which team member's AI agent made those calls, he goes to the Logs page, filters by the Create Invoice tool and the relevant date range, and immediately identifies the ZUID and Execution ID linked to each action giving him everything he needs to investigate and correct the issue.

Each log entry captures the following:

Field	What It Tells You
Tool	The specific Zoho Billing action that was called, such as Create Invoice or Get Records.
Status	Whether the tool call succeeded or failed.
ZUID	The Zoho User ID of the person whose AI agent triggered the action.
Execution ID	A unique identifier for that specific tool call, useful when escalating an issue or cross-referencing with API logs.

View Logs

The Logs page records every action performed through your Zoho MCP server. Each log entry captures what tool was used, who triggered it, whether it succeeded, and a unique identifier you can use to trace that specific execution.

Log in to Zoho MCP account.
Select the MCP server for which you’d like to view activity logs.
Go to Logs in the left sidebar.
Set filters Date, Time, Timezone, Status, Tool, ZUID, or Execution ID to narrow down the results.
Click Search to view matching log entries.

Note: You can combine multiple filters in a single search. For example, filtering by both a specific Tool and a Status of Failed will show you all unsuccessful calls to that tool within your chosen date range, making it easier to pinpoint issues without scrolling through unrelated entries.

Review Logs by User

If you need to review activity tied to a specific user or a specific tool, you can filter the logs accordingly.

To review all actions performed by a specific user:

Log in to your Zoho MCP account.
Select the MCP server for which you want to review performed actions.
Go to Logs in the left sidebar.
Enter the user’s ZUID in the ZUID field.
Click Search.

All tool calls made by that user’s AI agent will appear, along with the tool name, execution status, and timestamp for each action.

To review all calls made to a specific tool:

Log in to your Zoho MCP account.
Select the MCP Server that you’d like to manage.
Go to Logs on the left sidebar.
Select the tool from the Tool dropdown.
Click Search.

You can view the logs based on the calls made for that specific tool. All calls made for that specific tool will appear in the results.

Manage Your Connections

A connection provides your AI agent with the access credentials such as OAuth access tokens and refresh tokens needed to interact with external services. Without one, the AI agent can receive a prompt and identify the right tool, but cannot execute any actions.

Depending on how your organization works, you can choose to let each user authorize access themselves when they first use a tool, or you can set up a single admin-managed connection that powers all tool calls across the organization. Both approaches are supported, and you can switch between them at any time. Learn More

Was this document helpful?

Yes