Zoho CRM MCP demo

Un pequeño servidor MCP que expone cuatro operaciones de Zoho CRM (módulos Deals y Leads, nombres de campo reales de la API v8 de Zoho) como herramientas que un LLM/agente puede invocar en lenguaje natural:

• search_deals(stage=None, min_amount=None) — filtra el pipeline por etapa/importe

• summarize_pipeline() — recuento de deals + importe total de Amount por etapa, abiertos frente a cerrados

• find_duplicate_leads() — agrupa los Leads por (Email, Company) para detectar cuando el mismo contacto entra por dos canales de captura distintos con el nombre escrito de forma ligeramente diferente (p. ej., un formulario de extensión de Marketplace frente a un webhook)

• create_lead(first_name, last_name, company, email, lead_source) — añade un Lead

Por qué existe

Construido como una prueba de concepto breve y autocontenida — no es una entrega vinculada a ningún trabajo de cliente concreto. Se ejecuta completamente contra el conjunto de datos sintéticos en data/seed.json; no hay conexión con una organización real de Zoho CRM ni datos de CRMOZ ni de clientes en ningún punto.

Refleja el mismo patrón que el trabajo MCP de producción ya publicado en otras implementaciones (integraciones MCP de n8n, una integración MCP de GoHighLevel para un cliente real) — aplicado aquí al esquema de Zoho CRM, para demostrar que el patrón encaja, no para sustituir ninguna herramienta existente de «IA + Zoho».

Related MCP server: Zoho CRM MCP Server

Ejecutarlo

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

Esto inicia el servidor en stdio, listo para añadirse como servidor local a la configuración de cualquier cliente MCP (Claude Desktop, Claude Code, etc.).

Comprobado y funcionando

Las cuatro herramientas se probaron directamente y a través de mcp.list_tools(): search_deals, summarize_pipeline, find_duplicate_leads y create_lead se registraron y devolvieron la salida correcta contra los datos de seed, incluido un lead duplicado plantado deliberadamente (sam.cutter@bramwellfoods.example, introducido una vez a través de un canal de tipo «Email to Lead» y otra vez a través de un canal de tipo «Google Sheets», con el nombre escrito como «Sam» frente a «Samuel») que find_duplicate_leads() captó correctamente.