zoho-crm-mcp

# Zoho CRM MCP Server A 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. ## Features - **Full OAuth2 Authentication**: Secure authentication with Zoho CRM using OAuth2 flow - **Environment Variables**: Secure credential management using .env files - **Contact Management**: Search, create, and update contacts - **Deal Management**: Search, create, and list deals - **User Information**: Get current user details - **STDIO Transport**: Compatible with MCP clients using standard input/output - **Error Handling**: Comprehensive error handling with clear error messages - **Token Management**: Automatic access token refresh - **PyPI Ready**: Installable via pip/uvx for easy distribution ## Prerequisites - Python 3.11 or higher - Zoho CRM account with API access - Zoho Developer Console app credentials ## Installation ### Option 1: Install from PyPI (Recommended) ```bash # Install using uvx (recommended for CLI tools) uvx zoho-crm-mcp # Or install using pip pip install zoho-crm-mcp ``` ### Option 2: Install from Source 1. **Clone this repository**: ```bash git clone <repository-url> cd zoho-crm-mcp ``` 2. **Install dependencies**: ```bash uv sync # or pip install -e . ``` ## Setup ### Step 1: Create Zoho Developer App 1. Go to [Zoho Developer Console](https://api-console.zoho.com/) 2. Create a new "Server-based Applications" app 3. Note down your `Client ID` and `Client Secret` 4. Set redirect URI to `http://localhost:8080/callback` ### Step 2: Configure Environment Variables Create a `.env` file in your working directory: ```bash # Copy the example file cp .env.example .env ``` Edit `.env` with your credentials: ```env ZOHO_CLIENT_ID=your_actual_client_id ZOHO_CLIENT_SECRET=your_actual_client_secret ZOHO_REDIRECT_URI=http://localhost:8080/callback ZOHO…