Zoho CRM Server
FreeNot checkedExposes Zoho CRM v6 REST API as structured tools for LLM agents via MCP, enabling CRUD operations, search, COQL queries, and more.
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,<2httpx>=0.27.1,<1.0.0pydantic>=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
Install Zoho CRM Server in Claude Desktop, Claude Code & Cursor
unyly install zoho-crm-mcp-serverInstalls 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-serverFAQ
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
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare 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
