Skip to content
MCP server

Zoho Crm

MCP server that lets AI assistants read and write Zoho CRM leads, contacts and deals

Runs locally
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Zoho Crm

Zoho Crm is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ZOHO_CRM_API_KEYAPI Key for ZOHO_CRMRequired
  • ZOHO_CRM_API_URLAPI URL for ZOHO_CRM

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licensed open-source server; Zoho CRM itself requires a separate Zoho account.

Zoho Crm 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.

How AIPoweredBot checks servers