# Zoho Crm

> Zoho Crm is an open-source MCP server for sales and crm. MCP server that lets AI assistants read and write Zoho CRM leads, contacts and deals. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/asklokesh/zoho-crm-mcp-server
- **MCP Registry name:** io.github.asklokesh/zoho-crm-mcp-server
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-18

## About

The README describes this as a bridge between Zoho CRM and AI assistants, so a client can query and update CRM records through the Model Context Protocol instead of the Zoho web interface. Authentication uses Zoho's OAuth 2.0 self-client flow with a refresh token, and the server refreshes access tokens on its own when they expire.

Beyond the basic lead, contact and deal operations, the server adds rate limiting tuned to Zoho API quotas, retries with exponential backoff for network errors, and configurable logging. A Python client class is also exposed for scripts that need the same calls outside an MCP host.

It suits developers and sales-operations teams who already run Zoho CRM and want an AI client to look up or create records. The README is the only source, and it notes the PyPI package is not yet published, so installation currently runs from source.

## Features

- **OAuth token refresh:** Uses Zoho's OAuth 2.0 refresh token flow and renews access tokens automatically when they expire.
- **Lead, contact and deal tools:** Exposes tools to fetch leads, create leads, fetch contacts and fetch deals with pagination.
- **Generic record search:** Searches any Zoho CRM module using a custom criteria string.
- **Rate limiting:** Caps request volume using configurable limits to stay within Zoho API quotas.
- **Retry with backoff:** Retries failed network calls with exponential backoff up to a configurable maximum.
- **Async Python client:** Provides an asynchronous Python client class for calling Zoho CRM directly from code.

## Good for

- Asking an AI assistant to pull the latest leads or deals from Zoho CRM
- Creating a new lead in Zoho CRM from a conversation or script
- Searching contact or lead records by email address
- Building a custom sales assistant that reads CRM data through MCP

## Install

### Claude Code (Terminal)

```sh
claude mcp add zoho-crm-mcp-server --env ZOHO_CRM_API_KEY='<ZOHO_CRM_API_KEY>' -- uvx zoho-crm-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zoho-crm-mcp-server": {
      "command": "uvx",
      "args": [
        "zoho-crm-mcp-server"
      ],
      "env": {
        "ZOHO_CRM_API_KEY": "<ZOHO_CRM_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zoho-crm-mcp-server": {
      "command": "uvx",
      "args": [
        "zoho-crm-mcp-server"
      ],
      "env": {
        "ZOHO_CRM_API_KEY": "<ZOHO_CRM_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zoho-crm-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zoho-crm-mcp-server"
      ],
      "env": {
        "ZOHO_CRM_API_KEY": "<ZOHO_CRM_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zoho-crm-mcp-server": {
      "command": "uvx",
      "args": [
        "zoho-crm-mcp-server"
      ],
      "env": {
        "ZOHO_CRM_API_KEY": "<ZOHO_CRM_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zoho-crm-mcp-server": {
      "command": "uvx",
      "args": [
        "zoho-crm-mcp-server"
      ],
      "env": {
        "ZOHO_CRM_API_KEY": "<ZOHO_CRM_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_leads`: Retrieve leads from Zoho CRM with pagination
- `create_lead`: Create new leads in Zoho CRM
- `get_contacts`: Fetch contacts with pagination support
- `get_deals`: Get deals from Zoho CRM
- `search_records`: Search across any module with custom criteria

## FAQ

### Which Zoho CRM operations does the server expose as tools?

The README lists five tools: get_leads, create_lead, get_contacts, get_deals and search_records.

### How is the server authenticated to Zoho?

It uses a Zoho API self-client with a client ID, client secret and refresh token, requesting the ZohoCRM.modules.ALL and ZohoCRM.settings.ALL scopes.

### Is the package available on PyPI?

The README marks the PyPI installation as 'when published', so installation from source is the documented route.

### Is Zoho Crm free?

Yes. Zoho Crm is open source, so you can use and self-host it for free.

### How do I add Zoho Crm to Claude Code?

Run this command in your terminal: claude mcp add zoho-crm-mcp-server --env ZOHO_CRM_API_KEY='<ZOHO_CRM_API_KEY>' -- uvx zoho-crm-mcp-server

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Zoho CRM AI Assistant](https://ai-powered.com/mcp/zoho-crm-ai-assistant): Zoho CRM AI Assistant is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/zoho-crm-2
