Zoho Cliq
The Zoho Cliq connector lets AI agents read channel and user data, send channel messages and direct chats, create channels, and update status. It uses OAuth 2.0 so your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Zoho Cliq account.
| Scope | Purpose |
|---|---|
| ZohoCliq.Channels.ALL | Read channels and send messages to channels |
| ZohoCliq.Messages.ALL | Read and send direct messages |
Tool reference#
The Zoho Cliq connector exposes 10 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| zohocliq_list_channels | read | List all channels in Zoho Cliq |
| zohocliq_get_channel | read | Get details of a specific Zoho Cliq channel |
| zohocliq_list_messages | read | List messages in a Zoho Cliq channel |
| zohocliq_list_users | read | List all users in the Zoho Cliq organization |
| zohocliq_get_user | read | Get details of a specific Zoho Cliq user |
| zohocliq_list_buddies | read | List all direct message contacts (buddies) in Zoho Cliq |
| zohocliq_send_message | write | Send a message to a Zoho Cliq channel |
| zohocliq_send_chat | write | Send a direct message to a user in Zoho Cliq |
| zohocliq_create_channel | write | Create a new channel in Zoho Cliq |
| zohocliq_set_status | write | Set the status message for the current user in Zoho Cliq |
No delete tools
full_access preset without risk of removing conversation history.Common guardrail recipes#
Read-only access#
Apply the read_only preset to enable the six read tools and deny all write tools. Suitable for agents that summarise channel activity or look up user contact details without posting any messages.
Participate preset#
Use the participate preset to enable all 10 tools. This lets agents read and post to channels, send direct messages, and create new channels for project coordination.
Restrict to specific channels#
Apply a allow_values guardrail to zohocliq_send_message targeting the channel_name field with the names of channels the agent is permitted to post in. This prevents the agent from broadcasting to sensitive or unrelated channels.
Troubleshooting#
- Channel unique name vs display name — Zoho Cliq uses a unique channel name (slug) for API operations, not the display name shown in the UI. Use
zohocliq_list_channelsto find the correct unique name before sending messages. - Direct message requires email or ID —
zohocliq_send_chatrequires the recipient's Zoho user email or Cliq user ID. Usezohocliq_list_usersorzohocliq_list_buddiesto look up the correct identifier. - Bot token vs user token — If you connect Zoho Cliq using a bot OAuth token, some user-centric tools like
zohocliq_set_statusmay not be available. Use a personal user OAuth connection for full functionality.