> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/zoho-crm-mcp.md).

# Zoho CRM MCP

Zoho CRM MCP lets your AI agent use the tools that Zoho CRM publishes. Zoho CRM publishes many tools, about 174, so choose only the ones your agent needs. You add the MCP server URL once in Third party apps.

***

### Prerequisites

* A BotPenguin account with access to the More menu.&#x20;
* A Zoho CRM account.
* Your MCP URL from the MCP settings in Zoho CRM.

***

### Key Definitions

| Term           | Meaning                                                                                 |
| -------------- | --------------------------------------------------------------------------------------- |
| MCP            | Model Context Protocol. A standard way for an AI agent to use the tools of another app. |
| MCP server URL | The address of the MCP server.                                                          |
| Tool           | An action that the app publishes. The app decides which tools exist.                    |
| Connection     | One saved account that your agents can use.                                             |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/yZeOLaCQP2ElN0HX3Fb9/images/zoho-crm-mcp-step-1.png)

2. Type Zoho CRM MCP in the search box, then open the **Zoho CRM MCP** card. \[CHECK: the prototype has no Zoho CRM MCP card, so this step and the next have no screenshot. Add them.]
3. On the Connected accounts tab, click **Add connection**.
4. In the configuration panel, type a **Configuration name**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FYJF77fWV8i77fMcOK3ub%2Fimage.png?alt=media&amp;token=9f052ca5-986a-4936-bb03-0499392bbbd6" alt=""><figcaption></figcaption></figure>

5. Enter the **MCP server URL**. This field is required. Copy it from the MCP settings in Zoho CRM.
6. Click **Save Configuration**. BotPenguin tests the connection and saves it only if the server answers.
7. Check the Connected accounts tab. Your Zoho CRM MCP configuration appears in the list with an Active status.

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>Save Configuration is grey</summary>

Fill in every required field. The URL must start with https\://.

</details>

<details>

<summary>BotPenguin says authentication is required</summary>

The token or header is missing or wrong. Copy the key again from Zoho CRM and save again.

</details>

<details>

<summary>BotPenguin says the server could not be found</summary>

The URL is wrong or the server is down. Check the URL in Zoho CRM and save again.

</details>

<details>

<summary>My agent says the credentials were rejected</summary>

The key was regenerated or deleted in Zoho CRM. Add the connection again with the new key.

</details>

<details>

<summary>The tools in my agent changed</summary>

Zoho CRM publishes the tools, not BotPenguin. Sync the tools again in your agent and select the ones you need.

</details>

<details>

<summary>Can I connect more than one Zoho CRM MCP account?</summary>

Yes. Click Add connection again. Give each one a clear name so you can pick the right one when you build an agent.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
