Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Zoho CRM Server

FreeNot checked

Exposes Zoho CRM v6 REST API as structured tools for LLM agents via MCP, enabling CRUD operations, search, COQL queries, and more.

GitHubEmbed

About

Exposes Zoho CRM v6 REST API as structured tools for LLM agents via MCP, enabling CRUD operations, search, COQL queries, and more.

README

A Model Context Protocol (MCP) server that exposes the Zoho CRM v6 REST API as structured tools for LLM agents. Built on FastMCP with async httpx, pydantic v2 configuration, and an OAuth2 refresh-token flow.

Features

  • OAuth2 refresh-token exchange with in-memory access-token caching (1 hour TTL)
  • Automatic retry once on HTTP 401 after forcing a token refresh
  • Typed errors (AuthenticationError, NotFoundError, RateLimitError, APIError)
  • Region-aware endpoints: com, eu, in, com.au, jp
  • Full CRUD for any CRM module, plus search, COQL, module metadata, user listing, and related-list traversal

Requirements

  • Python 3.10+
  • mcp>=1.27,<2
  • httpx>=0.27.1,<1.0.0
  • pydantic>=2.12, pydantic-settings>=2.5.2

Install

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Configuration

All settings use the ZOHO_ env prefix (or a .env file):

Variable Default Description
ZOHO_CLIENT_ID - OAuth2 client id
ZOHO_CLIENT_SECRET - OAuth2 client secret
ZOHO_REFRESH_TOKEN - OAuth2 refresh token
ZOHO_REGION com One of com, eu, in, com.au, jp
ZOHO_TIMEOUT 30 HTTP timeout in seconds

Run

zoho-crm-mcp

Or register it in an MCP-capable client with the stdio command above.

Tools

Tool Zoho CRM endpoint
list_records GET /crm/v6/{module}
get_record GET /crm/v6/{module}/{id}
create_record POST /crm/v6/{module}
update_record PUT /crm/v6/{module}/{id}
delete_record DELETE /crm/v6/{module}/{id}
search_records GET /crm/v6/{module}/search
list_modules GET /crm/v6/settings/modules
get_module GET /crm/v6/settings/modules/{module}
list_users GET /crm/v6/users
coql_query POST /crm/v6/coql
list_related_records GET /crm/v6/{module}/{id}/{related_list}

Test

pytest -x --tb=short

License

MIT

from github.com/LokiMCPUniverse/zoho-crm-mcp-server

Install Zoho CRM Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install zoho-crm-mcp-server

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add zoho-crm-mcp-server -- uvx zoho-crm-mcp-server

FAQ

Is Zoho CRM Server MCP free?

Yes, Zoho CRM Server MCP is free — one-click install via Unyly at no cost.

Does Zoho CRM Server need an API key?

No, Zoho CRM Server runs without API keys or environment variables.

Is Zoho CRM Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Zoho CRM Server in Claude Desktop, Claude Code or Cursor?

Open Zoho CRM Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Zoho CRM Server with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs