{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_scv4vpnv6kny","handle":"zoho-crm-mcp","url":"https://wellknown.network/agents/zoho-crm-mcp","links":{"self":"https://wellknown.network/agents/zoho-crm-mcp/record.json","html":"https://wellknown.network/agents/zoho-crm-mcp","markdown":"https://wellknown.network/agents/zoho-crm-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zoho-crm-mcp","status":"https://wellknown.network/api/v1/agents/zoho-crm-mcp/status","claim":"https://wellknown.network/agents/zoho-crm-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zoho-crm-mcp/claim.json","badge":"https://wellknown.network/agents/zoho-crm-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zoho-crm-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zoho-crm-mcp","summary":"Model Context Protocol server for Zoho CRM integration","description":"# Zoho CRM MCP Server\n\nA Model Context Protocol (MCP) server that provides seamless integration with Zoho CRM. This server exposes Zoho CRM functionality as MCP tools that can be used by AI assistants like Claude, GPT, and other MCP-compatible clients.\n\n## Features\n\n- **Full OAuth2 Authentication**: Secure authentication with Zoho CRM using OAuth2 flow\n- **Environment Variables**: Secure credential management using .env files\n- **Contact Management**: Search, create, and update contacts\n- **Deal Management**: Search, create, and list deals\n- **User Information**: Get current user details\n- **STDIO Transport**: Compatible with MCP clients using standard input/output\n- **Error Handling**: Comprehensive error handling with clear error messages\n- **Token Management**: Automatic access token refresh\n- **PyPI Ready**: Installable via pip/uvx for easy distribution\n\n## Prerequisites\n\n- Python 3.11 or higher\n- Zoho CRM account with API access\n- Zoho Developer Console app credentials\n\n## Installation\n\n### Option 1: Install from PyPI (Recommended)\n\n```bash\n# Install using uvx (recommended for CLI tools)\nuvx zoho-crm-mcp\n\n# Or install using pip\npip install zoho-crm-mcp\n```\n\n### Option 2: Install from Source\n\n1. **Clone this repository**:\n   ```bash\n   git clone <repository-url>\n   cd zoho-crm-mcp\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   uv sync\n   # or\n   pip install -e .\n   ```\n\n## Setup\n\n### Step 1: Create Zoho Developer App\n\n1. Go to [Zoho Developer Console](https://api-console.zoho.com/)\n2. Create a new \"Server-based Applications\" app\n3. Note down your `Client ID` and `Client Secret`\n4. Set redirect URI to `http://localhost:8080/callback`\n\n### Step 2: Configure Environment Variables\n\nCreate a `.env` file in your working directory:\n\n```bash\n# Copy the example file\ncp .env.example .env\n```\n\nEdit `.env` with your credentials:\n```env\nZOHO_CLIENT_ID=your_actual_client_id\nZOHO_CLIENT_SECRET=your_actual_client_secret\nZOHO_REDIRECT_URI=http://localhost:8080/callback\nZOHO…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:zoho-crm-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.crm","name":"CRM & Sales","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"}],"categories":["dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"zoho-crm-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:37.581Z","publishedAt":"2025-07-03T14:15:19.487840Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zoho-crm-mcp","url":"https://pypi.org/project/zoho-crm-mcp/","firstSeenAt":"2026-09-10T16:24:01.877Z","fetchedAt":"2026-09-10T16:24:01.877Z","normalizedAt":"2026-09-10T16:24:01.877Z"}]},"firstSeenAt":"2026-09-10T16:24:01.877Z","updatedAt":"2026-09-10T16:24:37.581Z"}