Zoho CRM Automation via Rube MCP
Automate Zoho CRM operations through Composio's Zoho toolkit via Rube MCP.
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.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit zoho
- If connection is not ACTIVE, follow the returned auth link to complete Zoho OAuth
- 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:
ZOHO_LIST_MODULES - List available CRM modules [Prerequisite]
ZOHO_GET_MODULE_FIELDS - Get field definitions for a module [Optional]
ZOHO_SEARCH_ZOHO_RECORDS - Search records by criteria [Required]
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:john@example.com')
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:john@example.com)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:
ZOHO_GET_MODULE_FIELDS - Get required fields for the module [Prerequisite]
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:
ZOHO_SEARCH_ZOHO_RECORDS - Find the record to update [Prerequisite]
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:
ZOHO_SEARCH_ZOHO_RECORDS - Find the lead to convert [Prerequisite]
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:
ZOHO_CREATE_ZOHO_TAG - Create a new tag [Optional]
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:john@example.com)'
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 |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
1---2name: zoho-crm-automation3description: "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."4requires:5 mcp: [rube]6risk: unknown7source: community8metadata:9 source: https://skillmd.com/skills/mayurrathi/zoho-crm-automation10---1112# Zoho CRM Automation via Rube MCP1314Automate Zoho CRM operations through Composio's Zoho toolkit via Rube MCP.1516## Prerequisites1718- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)19- Active Zoho CRM connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `zoho`20- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2122## Setup2324**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.2526271. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds282. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `zoho`293. If connection is not ACTIVE, follow the returned auth link to complete Zoho OAuth304. Confirm connection status shows ACTIVE before running any workflows3132## Core Workflows3334### 1. Search and Retrieve Records3536**When to use**: User wants to find specific CRM records by criteria3738**Tool sequence**:391. `ZOHO_LIST_MODULES` - List available CRM modules [Prerequisite]402. `ZOHO_GET_MODULE_FIELDS` - Get field definitions for a module [Optional]413. `ZOHO_SEARCH_ZOHO_RECORDS` - Search records by criteria [Required]424. `ZOHO_GET_ZOHO_RECORDS` - Get records from a module [Alternative]4344**Key parameters**:45- `module`: Module name (e.g., 'Leads', 'Contacts', 'Deals', 'Accounts')46- `criteria`: Search criteria string (e.g., 'Email:equals:john@example.com')47- `fields`: Comma-separated list of fields to return48- `per_page`: Number of records per page49- `page`: Page number for pagination5051**Pitfalls**:52- Module names are case-sensitive (e.g., 'Leads' not 'leads')53- Search criteria uses specific syntax: 'Field:operator:value'54- Supported operators: equals, starts_with, contains, not_equal, greater_than, less_than55- Complex criteria use parentheses and AND/OR: '(Email:equals:john@example.com)AND(Last_Name:equals:Doe)'56- GET_ZOHO_RECORDS returns all records with optional filtering; SEARCH is for targeted lookups5758### 2. Create Records5960**When to use**: User wants to add new leads, contacts, deals, or other CRM records6162**Tool sequence**:631. `ZOHO_GET_MODULE_FIELDS` - Get required fields for the module [Prerequisite]642. `ZOHO_CREATE_ZOHO_RECORD` - Create a new record [Required]6566**Key parameters**:67- `module`: Target module name (e.g., 'Leads', 'Contacts')68- `data`: Record data object with field-value pairs69- Required fields vary by module (e.g., Last_Name for Contacts)7071**Pitfalls**:72- Each module has mandatory fields; use GET_MODULE_FIELDS to identify them73- Field names use underscores (e.g., 'Last_Name', 'Email', 'Phone')74- Lookup fields require the related record ID, not the name75- Date fields must use 'yyyy-MM-dd' format76- Creating duplicates is allowed unless duplicate check rules are configured7778### 3. Update Records7980**When to use**: User wants to modify existing CRM records8182**Tool sequence**:831. `ZOHO_SEARCH_ZOHO_RECORDS` - Find the record to update [Prerequisite]842. `ZOHO_UPDATE_ZOHO_RECORD` - Update the record [Required]8586**Key parameters**:87- `module`: Module name88- `record_id`: ID of the record to update89- `data`: Object with fields to update (only changed fields needed)9091**Pitfalls**:92- record_id must be the Zoho record ID (numeric string)93- Only provide fields that need to change; other fields are preserved94- Read-only and system fields cannot be updated95- Lookup field updates require the related record ID9697### 4. Convert Leads9899**When to use**: User wants to convert a lead into a contact, account, and/or deal100101**Tool sequence**:1021. `ZOHO_SEARCH_ZOHO_RECORDS` - Find the lead to convert [Prerequisite]1032. `ZOHO_CONVERT_ZOHO_LEAD` - Convert the lead [Required]104105**Key parameters**:106- `lead_id`: ID of the lead to convert107- `deal`: Deal details if creating a deal during conversion108- `account`: Account details for the conversion109- `contact`: Contact details for the conversion110111**Pitfalls**:112- Lead conversion is irreversible; the lead record is removed from the Leads module113- Conversion can create up to three records: Contact, Account, and Deal114- Existing account matching may occur based on company name115- Custom field mappings between Lead and Contact/Account/Deal modules affect the outcome116117### 5. Manage Tags and Related Records118119**When to use**: User wants to tag records or manage relationships between records120121**Tool sequence**:1221. `ZOHO_CREATE_ZOHO_TAG` - Create a new tag [Optional]1232. `ZOHO_UPDATE_RELATED_RECORDS` - Update related/linked records [Optional]124125**Key parameters**:126- `module`: Module for the tag127- `tag_name`: Name of the tag128- `record_id`: Parent record ID (for related records)129- `related_module`: Module of the related record130- `data`: Related record data to update131132**Pitfalls**:133- Tags are module-specific; a tag created for Leads is not available in Contacts134- Related records require both the parent record ID and the related module135- Tag names must be unique within a module136- Bulk tag operations may hit rate limits137138## Common Patterns139140### Module and Field Discovery141142```1431. Call ZOHO_LIST_MODULES to get all available modules1442. Call ZOHO_GET_MODULE_FIELDS with module name1453. Identify required fields, field types, and picklist values1464. Use field API names (not display labels) in data objects147```148149### Search Criteria Syntax150151**Simple search**:152```153criteria: '(Email:equals:john@example.com)'154```155156**Combined criteria**:157```158criteria: '((Last_Name:equals:Doe)AND(Email:contains:example.com))'159```160161**Supported operators**:162- `equals`, `not_equal`163- `starts_with`, `contains`164- `greater_than`, `less_than`, `greater_equal`, `less_equal`165- `between` (for dates/numbers)166167### Pagination168169- Set `per_page` (max 200) and `page` starting at 1170- Check response `info.more_records` flag171- Increment page until more_records is false172- Total count available in response info173174## Known Pitfalls175176**Field Names**:177- Use API names, not display labels (e.g., 'Last_Name' not 'Last Name')178- Custom fields have API names like 'Custom_Field1' or user-defined names179- Picklist values must match exactly (case-sensitive)180181**Rate Limits**:182- API call limits depend on your Zoho CRM plan183- Free plan: 5000 API calls/day; Enterprise: 25000+/day184- Implement delays between bulk operations185- Monitor 429 responses and respect rate limit headers186187**Data Formats**:188- Dates: 'yyyy-MM-dd' format189- DateTime: 'yyyy-MM-ddTHH:mm:ss+HH:mm' format190- Currency: Numeric values without formatting191- Phone: String values (no specific format enforced)192193**Module Access**:194- Access depends on user role and profile permissions195- Some modules may be hidden or restricted in your CRM setup196- Custom modules have custom API names197198## Quick Reference199200| Task | Tool Slug | Key Params |201|------|-----------|------------|202| List modules | ZOHO_LIST_MODULES | (none) |203| Get module fields | ZOHO_GET_MODULE_FIELDS | module |204| Search records | ZOHO_SEARCH_ZOHO_RECORDS | module, criteria |205| Get records | ZOHO_GET_ZOHO_RECORDS | module, fields, per_page, page |206| Create record | ZOHO_CREATE_ZOHO_RECORD | module, data |207| Update record | ZOHO_UPDATE_ZOHO_RECORD | module, record_id, data |208| Convert lead | ZOHO_CONVERT_ZOHO_LEAD | lead_id, deal, account, contact |209| Create tag | ZOHO_CREATE_ZOHO_TAG | module, tag_name |210| Update related records | ZOHO_UPDATE_RELATED_RECORDS | module, record_id, related_module, data |211212## When to Use213This skill is applicable to execute the workflow or actions described in the overview.