Skip to main content
skill CX Codex

zoho-crm-automation — Claude Code skill: Zoho CRM automation

zoho-crm-automation — a skill for automating Zoho CRM operations via Rube MCP: create and update records, search contacts, manage leads, and convert them. Requires active Zoho subscription and Rube MCP connection.

MIT 121 installs ★ 3,785 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add davepoon/buildwithclaude --skill zoho-crm-automation -a claude-code
Open on GitHub

What zoho-crm-automation does

zoho-crm-automation lets you search CRM records by criteria, create new contacts and leads, update existing records, and convert leads into contacts and deals. The skill runs through Rube MCP with Composio's Zoho tools — all you need is to add the endpoint https://rube.app/mcp to your client configuration.

Before each operation, the skill retrieves current field schemas via RUBE_SEARCH_TOOLS, so it works with custom modules and user-defined fields. It supports complex searches with AND/OR operators, pagination, related record updates, and tagging. Field names use underscores (Last_Name, not Last Name), dates are in yyyy-MM-dd format, and picklist values must match exactly.

Rate limits depend on your Zoho plan: free gives 5000 API calls per day, Enterprise offers 25000 and up. Bulk operations need delays between calls. Lead conversion is permanent — the lead record is removed from the Leads module.

What it helps with

  • find a contact or lead by email or name
  • create a new record (contact, lead, deal) with field values
  • update an existing contact or lead
  • convert a lead into a contact and deal
  • tag records and manage related record links

Example prompts for the agent

  • Search all leads where email contains example.com and status is New
  • Create a contact named John Doe, email [email protected], phone +1-555-123-4567
  • Update the last call date for contact ID 123456789 to 2025-01-15

How to install zoho-crm-automation

1Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill zoho-crm-automation -a claude-code

2Manually: put the files in place

~/.claude/skills/zoho-crm-automation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/zoho-crm-automation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about zoho-crm-automation

How do I install zoho-crm-automation?

Run npx skills add davepoon/buildwithclaude --skill zoho-crm-automation -a claude-code. Then add the MCP endpoint https://rube.app/mcp to your Claude Code configuration. The skill loads from ~/.claude/skills/zoho-crm-automation/SKILL.md.

What do I need to use this skill?

An active Zoho CRM subscription, Rube MCP connected, and OAuth authorization via RUBE_MANAGE_CONNECTIONS with toolkit zoho on first use. No API keys required.

What are the API rate limits?

Limits depend on your Zoho plan: free tier allows 5000 calls per day, Enterprise 25000 and up. Add delays between bulk operations and watch for 429 responses when limits are reached.

Source text

SKILL.md · MIT
---
name: zoho-crm-automation
description: "Automate Zoho CRM tasks via Rube MCP (Composio): create/update records, search contacts, manage leads, and convert leads. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: crm
---

# Zoho CRM Automation via Rube MCP

Automate Zoho CRM operations through Composio's Zoho toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/zoho](https://composio.dev/toolkits/zoho)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Zoho CRM connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `zoho`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `zoho`
3. If connection is not ACTIVE, follow the returned auth link to complete Zoho OAuth
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Search and Retrieve Records

**When to use**: User wants to find specific CRM records by criteria

**Tool sequence**:
1. `ZOHO_LIST_MODULES` - List available CRM modules [Prerequisite]
2. `ZOHO_GET_MODULE_FIELDS` - Get field definitions for a module [Optional]
3. `ZOHO_SEARCH_ZOHO_RECORDS` - Search records by criteria [Required]
4. `ZOHO_GET_ZOHO_RECORDS` - Get records from a module [Alternative]

**Key parameters**:
- `module`: Module name (e.g., 'Leads', 'Contacts', 'Deals', 'Accounts')
- `criteria`: Search criteria string (e.g., 'Email:equals:[email protected]')
- `fields`: Comma-separated list of fields to return
- `per_page`: Number of records per page
- `page`: Page number for pagination

**Pitfalls**:
- Module names are case-sensitive (e.g., 'Leads' not 'leads')
- Search criteria uses specific syntax: 'Field:operator:value'
- Supported operators: equals, starts_with, contains, not_equal, greater_than, less_than
- Complex criteria use parentheses and AND/OR: '(Email:equals:[email protected])AND(Last_Name:equals:Doe)'
- GET_ZOHO_RECORDS returns all records with optional filtering; SEARCH is for targeted lookups

### 2. Create Records

**When to use**: User wants to add new leads, contacts, deals, or other CRM records

**Tool sequence**:
1. `ZOHO_GET_MODULE_FIELDS` - Get required fields for the module [Prerequisite]
2. `ZOHO_CREATE_ZOHO_RECORD` - Create a new record [Required]

**Key parameters**:
- `module`: Target module name (e.g., 'Leads', 'Contacts')
- `data`: Record data object with field-value pairs
- Required fields vary by module (e.g., Last_Name for Contacts)

**Pitfalls**:
- Each module has mandatory fields; use GET_MODULE_FIELDS to identify them
- Field names use underscores (e.g., 'Last_Name', 'Email', 'Phone')
- Lookup fields require the related record ID, not the name
- Date fields must use 'yyyy-MM-dd' format
- Creating duplicates is allowed unless duplicate check rules are configured

### 3. Update Records

**When to use**: User wants to modify existing CRM records

**Tool sequence**:
1. `ZOHO_SEARCH_ZOHO_RECORDS` - Find the record to update [Prerequisite]
2. `ZOHO_UPDATE_ZOHO_RECORD` - Update the record [Required]

**Key parameters**:
- `module`: Module name
- `record_id`: ID of the record to update
- `data`: Object with fields to update (only changed fields needed)

**Pitfalls**:
- record_id must be the Zoho record ID (numeric string)
- Only provide fields that need to change; other fields are preserved
- Read-only and system fields cannot be updated
- Lookup field updates require the related record ID

### 4. Convert Leads

**When to use**: User wants to convert a lead into a contact, account, and/or deal

**Tool sequence**:
1. `ZOHO_SEARCH_ZOHO_RECORDS` - Find the lead to convert [Prerequisite]
2. `ZOHO_CONVERT_ZOHO_LEAD` - Convert the lead [Required]

**Key parameters**:
- `lead_id`: ID of the lead to convert
- `deal`: Deal details if creating a deal during conversion
- `account`: Account details for the conversion
- `contact`: Contact details for the conversion

**Pitfalls**:
- Lead conversion is irreversible; the lead record is removed from the Leads module
- Conversion can create up to three records: Contact, Account, and Deal
- Existing account matching may occur based on company name
- Custom field mappings between Lead and Contact/Account/Deal modules affect the outcome

### 5. Manage Tags and Related Records

**When to use**: User wants to tag records or manage relationships between records

**Tool sequence**:
1. `ZOHO_CREATE_ZOHO_TAG` - Create a new tag [Optional]
2. `ZOHO_UPDATE_RELATED_RECORDS` - Update related/linked records [Optional]

**Key parameters**:
- `module`: Module for the tag
- `tag_name`: Name of the tag
- `record_id`: Parent record ID (for related records)
- `related_module`: Module of the related record
- `data`: Related record data to update

**Pitfalls**:
- Tags are module-specific; a tag created for Leads is not available in Contacts
- Related records require both the parent record ID and the related module
- Tag names must be unique within a module
- Bulk tag operations may hit rate limits

## Common Patterns

### Module and Field Discovery

```
1. Call ZOHO_LIST_MODULES to get all available modules
2. Call ZOHO_GET_MODULE_FIELDS with module name
3. Identify required fields, field types, and picklist values
4. Use field API names (not display labels) in data objects
```

### Search Criteria Syntax

**Simple search**:
```
criteria: '(Email:equals:[email protected])'
```

**Combined criteria**:
```
criteria: '((Last_Name:equals:Doe)AND(Email:contains:example.com))'
```

**Supported operators**:
- `equals`, `not_equal`
- `starts_with`, `contains`
- `greater_than`, `less_than`, `greater_equal`, `less_equal`
- `between` (for dates/numbers)

### Pagination

- Set `per_page` (max 200) and `page` starting at 1
- Check response `info.more_records` flag
- Increment page until more_records is false
- Total count available in response info

## Known Pitfalls

**Field Names**:
- Use API names, not display labels (e.g., 'Last_Name' not 'Last Name')
- Custom fields have API names like 'Custom_Field1' or user-defined names
- Picklist values must match exactly (case-sensitive)

**Rate Limits**:
- API call limits depend on your Zoho CRM plan
- Free plan: 5000 API calls/day; Enterprise: 25000+/day
- Implement delays between bulk operations
- Monitor 429 responses and respect rate limit headers

**Data Formats**:
- Dates: 'yyyy-MM-dd' format
- DateTime: 'yyyy-MM-ddTHH:mm:ss+HH:mm' format
- Currency: Numeric values without formatting
- Phone: String values (no specific format enforced)

**Module Access**:
- Access depends on user role and profile permissions
- Some modules may be hidden or restricted in your CRM setup
- Custom modules have custom API names

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| List modules | ZOHO_LIST_MODULES | (none) |
| Get module fields | ZOHO_GET_MODULE_FIELDS | module |
| Search records | ZOHO_SEARCH_ZOHO_RECORDS | module, criteria |
| Get records | ZOHO_GET_ZOHO_RECORDS | module, fields, per_page, page |
| Create record | ZOHO_CREATE_ZOHO_RECORD | module, data |
| Update record | ZOHO_UPDATE_ZOHO_RECORD | module, record_id, data |
| Convert lead | ZOHO_CONVERT_ZOHO_LEAD | lead_id, deal, account, contact |
| Create tag | ZOHO_CREATE_ZOHO_TAG | module, tag_name |
| Update related records | ZOHO_UPDATE_RELATED_RECORDS | module, record_id, related_module, data |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

From the same set235

The whole set →
close-automation close-automation automates Close CRM operations through Rube MCP, managing leads, call logging, SMS, tasks, and notes directly from your coding agent. CX Codex +1 122installs circleci-automation circleci-automation is a Claude Code skill for CircleCI via Rube MCP: trigger pipelines, check workflow and job status, and download artifacts and test results. Requires an active CircleCI connection via Composio. CX Codex +1 122installs posthog-automation posthog-automation — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that drives PostHog through Rube MCP (Composio). Covers event capture, feature flags, projects and user profiles. CX Codex +1 121installs wrike-automation wrike-automation controls Wrike work through Rube MCP: tasks, folders, projects, assignees, and status tracking. Useful when project actions should start in an AI coding client. CX Codex +1 121installs freshservice-automation freshservice-automation handles Freshservice ITSM workflows through Rube MCP, covering ticket creation, searches, bulk updates, and service requests. CX Codex +1 121installs stripe-automation stripe-automation handles Stripe customers, invoices, subscriptions, and refunds through Rube MCP directly in your coding agent. CX Codex +1 120installs mixpanel-automation The mixpanel-automation skill automates Mixpanel workflows: aggregate events, segment by properties, build funnels, query user profiles and cohorts. Works through Rube MCP (Composio) — requires an active Mixpanel connection. CX Codex +1 120installs coda-automation coda-automation controls Coda docs, tables, permissions, and exports through Rube MCP directly from your coding agent. CX Codex +1 120installs

Project sponsors

Companies that keep this analytics open