Zoho CRM MCP demo

Ein kleiner MCP-Server, der vier Zoho-CRM-Operationen (Deals- und Leads-Module, echte Feldnamen der Zoho API v8) als Tools bereitstellt, die ein LLM/Agent in natürlicher Sprache aufrufen kann:

• search_deals(stage=None, min_amount=None) — filtert die Pipeline nach stage/amount

• summarize_pipeline() — Anzahl der Deals + Gesamt-Amount pro Stage, offen vs. geschlossen

• find_duplicate_leads() — gruppiert Leads nach (Email, Company), um denselben Kontakt zu erkennen, der über zwei verschiedene Erfassungskanäle mit leicht abweichender Namensschreibung eintritt (z. B. über ein Marketplace-Erweiterungs-Formular vs. einen Webhook)

• create_lead(first_name, last_name, company, email, lead_source) — fügt einen Lead hinzu

Warum es das gibt

Gebaut als kurzer, eigenständiger Proof of Concept – keine Einreichung, die an eine bestimmte Kundenarbeit gebunden ist. Er läuft vollständig gegen den synthetischen Datensatz in data/seed.json; es besteht keine Verbindung zu einer echten Zoho-CRM-Organisation und keinerlei CRMOZ- oder Kundendaten sind enthalten.

Es spiegelt dasselbe Muster wider wie bereits anderweitig ausgelieferte MCP-Produktionsarbeit (n8n-MCP-Integrationen, eine GoHighLevel-MCP-Integration für einen Live-Kunden) – hier angewendet auf das Schema von Zoho CRM, um zu zeigen, dass das Muster passt, nicht um vorhandenes „AI + Zoho“-Tooling zu ersetzen.

Related MCP server: Zoho CRM MCP Server

Ausführen

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

Das startet den Server auf stdio und er ist bereit, in der Konfiguration eines beliebigen MCP-Clients (Claude Desktop, Claude Code usw.) als lokaler Server registriert zu werden.

Verifiziert funktionsfähig

Alle vier Tools wurden direkt und über mcp.list_tools() ausgeführt. search_deals, summarize_pipeline, find_duplicate_leads und create_lead waren alle registriert und lieferten korrekte Ausgaben gegen die Seed-Daten, einschließlich eines absichtlich eingefügten doppelten Leads (sam.cutter@bramwellfood.example, einmal über einen „Email to Lead“-Stil-Kanal und einmal über einen „Google Sheets“-Kanal eingegeben, den Namen einmal „Sam“ und einmal „Samuel“ geschrieben), den find_duplicate_leads() korrekt erkannte.