# Zoho CRM Admin MCP MCP

> Zoho CRM Admin gives your AI agent full administrative control over Zoho CRM users, roles, profiles, layouts, and territories. You can manage system settings—like updating user permissions or listing all available tags—all through natural conversation, without ever leaving your chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** crm-administration, user-management, role-based-access, layout-configuration, data-governance, system-settings

## Description

Need to manage a complex sales stack without opening twelve different tabs? This MCP lets you control the core admin functions of Zoho CRM entirely through your AI agent. You can check who's on the team using `zoho_list_users`, audit what features specific profiles are allowed, or map out the full reporting hierarchy with `zoho_list_roles`. If you need to build an automation that checks a user's permissions and then updates a record layout, this connector handles it. Because admin work involves highly sensitive credentials, Vinkius ensures your keys pass through a zero-trust proxy; they’re used only in transit and never saved to disk. You can query specific company details with `zoho_list_territories` or find exactly what fields show up on a record form using `zoho_list_layouts`. It's all about system visibility, giving you complete control over the CRM environment.

## Tools

### zoho_get_user
Gets complete details for a specific user, showing their role, profile, and last activity date.

### zoho_list_layouts
Lists page layouts for any CRM module, detailing the form structure, sections, and field arrangement.

### zoho_list_profiles
Returns a list of permission sets that control what features and modules users can access in the system.

### zoho_list_roles
Lists all organizational roles, showing their hierarchy structure (who reports to whom).

### zoho_list_tags
Provides a list of available tags for record categorization and quick filtering across the CRM.

### zoho_list_territories
Lists sales territories, including names, managers, and their parent hierarchy structure.

### zoho_list_users
Provides a roster of all CRM users with details like name, email, role, profile, and current status.

## Prompt Examples

**Prompt:** 
```
Search for leads from web form
```

**Response:** 
```
👥 **Leads from Web Form**
| Name | Email | Company | Status |
|---|---|---|---|
| John Smith | john@acme.com | Acme Corp | New |
| Maria Garcia | maria@beta.io | Beta Inc | Contacted |
```

**Prompt:** 
```
Create a deal: Enterprise Plan $25,000
```

**Response:** 
```
✅ **Deal Created!**
- Name: Enterprise Plan
- Amount: $25,000
- Stage: Qualification
- Closing: 2024-03-30
```

## Capabilities

### Audit User Credentials
Retrieve detailed information for any specific user, including their profile, role, and last activity.

### Manage System Permissions
List all available permission sets (profiles) to understand what features different users can access in the CRM.

### Map Organizational Structure
See the full chain of command by listing roles and understanding who reports to whom within the company.

### Query Record Metadata
Check the structure of any record form, seeing which sections and fields are visible based on the assigned layout.

### Categorize Records
List all available user-defined tags for quick filtering or data segmentation across different modules.

## Use Cases

### Onboarding a new Sales Team Member
The BDR lead asks the agent to check the current user roster using `zoho_list_users`. The agent then checks what profiles exist via `zoho_list_profiles` and suggests the correct access level, saving hours of manual setup.

### Reviewing Data Flow for a Large Deal
A manager wants to know if all leads from a specific region are correctly assigned. The agent uses `zoho_list_territories` first, then queries the records to confirm accurate geographic routing.

### Debugging Field Visibility Issues
The support team notices some users can't see an important field. They run `zoho_list_layouts` and compare it against `zoho_get_user` details to pinpoint the exact layout configuration problem.

### Auditing CRM Usage After a Merger
The admin uses `zoho_list_roles` and `zoho_list_users` together. The agent builds a report showing all existing roles and comparing them against the current team members to flag outdated permissions.

## Benefits

- Pinpoint permission gaps: Use `zoho_list_profiles` to see exactly what features different user groups are restricted from accessing. No more guesswork on who can do what.
- Map out the sales hierarchy: Running `zoho_list_roles` shows you the full reporting structure, letting you verify if data visibility aligns with your company chart.
- Keep track of personnel: Instead of exporting reports manually, run `zoho_list_users` to get a real-time roster of team members' status and roles.
- Configure forms without clicking: Use `zoho_list_layouts` to programmatically check if the correct fields are displayed on a record form for specific profiles.
- Segment data instantly: If you need to filter records by type, `zoho_list_tags` provides all available labels, making your AI agent smarter about categorization.

## How It Works

The bottom line is that you get system visibility without needing API calls or manual database queries.

1. Tell your agent to perform an admin task, like 'Show me the roles that manage Enterprise accounts.'
2. The MCP calls the relevant function using `zoho_list_roles` and filters the results based on your criteria.
3. Your agent receives a clean list of structured data, allowing you to approve changes or use the information in follow-up steps.

## Frequently Asked Questions

**How do I use the zoho_list_users tool in Zoho CRM Admin?**
The `zoho_list_users` tool returns a full roster of all team members, providing their name, email, role, and activity status. This is useful for quickly auditing who has access to the system.

**Can I check layout structure using zoho_list_layouts?**
Yes, `zoho_list_layouts` lists the page layouts for any module. It shows you exactly how fields are grouped into sections and what their display order is in the UI.

**Does this MCP help with user roles? Which tool do I use?**
You'll primarily use `zoho_list_roles` to see the organizational hierarchy, showing which users report up or down the chain. This helps map out data visibility rules.

**What is the best way to manage tags with zoho_list_tags?**
`zoho_list_tags` lists all available labels (like 'VIP' or 'Urgent') for quick record categorization. You can use this list to ensure new records are tagged correctly from the start.

**How do I use zoho_get_user to audit a specific team member's profile details?**
It provides comprehensive data on one user, including their full name, email, role, and activity history. You get the precise permissions (profile) and how long they’ve been active for detailed auditing.

**What kind of permission sets can I review using zoho_list_profiles?**
This tool lists all defined profiles, which control what features, modules, and actions a user group can access. It’s essential for understanding granular feature-level permissions across the organization.

**How does zoho_list_roles help me understand the sales hierarchy?**
It maps out the organizational structure by listing every role and showing its parent/reporting relationship. This clarifies who reports to whom, which is critical for understanding data visibility boundaries.

**If I need to map regional coverage, what does zoho_list_territories show?**
It lists all defined sales territories, including the territory name, its manager, and any parent territory. This helps you understand your geographic or segment-based sales organization.

**What Zoho CRM data can I access?**
Leads, Contacts, Accounts, Deals, Notes, and any custom module. All data respects your Zoho CRM permissions.

**How does authentication work?**
Uses Zoho OAuth 2.0 with a refresh token. Create a Self Client in the Zoho API Console, generate a refresh token, and provide Client ID, Client Secret, and Refresh Token.

**Does it support multi-region Zoho?**
Yes! Set your API domain: zohoapis.com (US), zohoapis.eu (EU), zohoapis.in (India), zohoapis.com.au (Australia), zohoapis.jp (Japan).