Zoho CRM MCP demo

Zoho CRM の 4 つのオペレーション（Deals モジュールと Leads モジュール、実際の Zoho API v8 フィールド名）を、LLM/エージェントが自然言語で呼び出せるツールとして公開する、小さな MCP サーバーです：

• search_deals(stage=None, min_amount=None) — パイプラインをステージ／金額でフィルタリングする

• summarize_pipeline() — ステージごとの案件数 + 合計 Amount（オープン vs. クローズ）

• find_duplicate_leads() — Leads を (Email, Company) でグループ化し、綴りが少し異なる名前で別の取り込み経路（例: Marketplace 拡張フォーム vs. webhook）から同じ連絡先が登録されるのを検出する

• create_lead(first_name, last_name, company, email, lead_source) — Lead を追加する

なぜ作ったのか

短く自己完結したコンセプト実証として作られたもので、特定のクライアント案件に紐づく成果物ではありません。data/seed.json 内の合成データセットに対してのみに動作し、実際の Zoho CRM 組織には接続せず、CRMOZ やクライアントデータが関与する箇所もどこにもありません。

既に本番で提供されている他案件の MCP 実装と同じパターン（n8n MCP インテグレーション、実運用中のクライアント向け GoHighLevel MCP インテグレーション）を、Zoho CRM のスキーマに適用したものです。既存の「AI + Zoho」ツールツールを置き換えるのではなく、このパターンがフィットすることを示すのが目的です。

Related MCP server: Zoho CRM MCP Server

実行する

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

このコマンドはサーバーを stdio 上で起動し、任意の MCP クライアント（Claude Desktop、Claude Code など）の設定にローカルサーバーとして追加できる状態にします。

動作確認

4 つのツールは直接、mcp.list_tools() 経由でも動作確認しました。search_deals、summarize_pipeline、find_duplicate_leads、create_lead はすべて登録され、シードデータに対して正しい出力を返しました。意図的に仕込んだ重複リード（same.cam.com の sam.cutter@example.com を、"Email to Lead" 系チャネルと "Google Sheets" 系チャネルで1回ずつ、名前の綴りを "Sam" と "Samuel" と変えて登録）も、find_duplicate_leads() が正しく検出できています。