How to integrate Zoho mail MCP with Grok Build

Connect Grok Build to Zoho mail MCP. Send a follow-up email to yesterday's meeting attendees, list unread emails from your manager, and more from your terminal, with authentication handled for you.

Zoho mail logoZoho mail
Oauth2

Zoho Mail is a secure and ad-free email hosting platform with collaboration features. It helps businesses communicate efficiently while maintaining privacy and administrative control.

45 Tools

How to integrate Zoho mail MCP with Grok Build

Grok Build is xAI's terminal coding agent. It runs on Grok 4.5, plans its work before it acts, and can run multiple sub-agents in parallel. It also reads Claude Code's MCP configuration, so any server you already have in a .mcp.json is picked up with no changes.

In this guide, I will show you how to connect your Zoho mail account to Grok Build through Composio, so it can send a follow-up email to yesterday's meeting attendees, list unread emails from your manager, schedule a calendar event from an email, and more without leaving the terminal. Composio holds the OAuth tokens for you, and Grok Build only calls the tools you approve.

Also integrate Zoho mail with

Why use Composio over a standalone MCP server?

  • Read and write access. Composio's Zoho mail integration lets Grok Build take real actions like creating drafts, sending updates, and labeling records, not just reading data.
  • 1,700+ SaaS toolkits out of the box. One endpoint gives you a full catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Wire up a single Composio server instead of maintaining a separate MCP entry for each app.
  • Smart, context-aware tool loading. Grok Build caps how many tools it holds in a single request. Composio loads only the tools a task needs, so you do not spend that budget on tools you are not using.
  • Cross-app automation. Chain actions across apps in one run. Pull a thread, summarize it in Notion, and post the highlights to Slack from a single prompt.

Prerequisites

  • Grok Build installed and signed in. Install with curl -fsSL https://x.ai/cli/install.sh | bash on macOS or Linux, or irm https://x.ai/cli/install.ps1 | iex on Windows PowerShell. On first launch Grok opens a browser to authenticate; for headless or CI use, set an XAI_API_KEY environment variable instead (create the key at console.x.ai).
  • Access to the Zoho mail account you want to connect.
  • The Composio MCP endpoint. Composio's server is remote and hosted, so there is nothing to run locally and no tunnel to set up.

Step-by-step: Connect Zoho mail to Grok Build

1. Install and verify Grok Build

Install the CLI, then restart your shell so the grok binary lands on your PATH:

bash
curl -fsSL https://x.ai/cli/install.sh | bash
which grok

On Windows, install with PowerShell instead: irm https://x.ai/cli/install.ps1 | iex. If which grok returns a path, you are set. Grok Build runs on Grok 4.5 by default; you can switch models inside the session with /model <name>.

2. Add the Composio server

Add Composio as a remote HTTP MCP server with the grok mcp add command:

bash
grok mcp add --transport http composio https://connect.composio.dev/mcp

You can also add and manage servers from inside a session. Run /mcps to open the extensions modal on the MCP tab, then add a new server and paste the Composio URL. Added this way, Grok auto-detects the name from the URL and lists the server as connect:

bash
https://connect.composio.dev/mcp
Grok Build /mcps extensions modal listing MCP servers Grok Build adding the Composio MCP server with its URL

Grok also reads Claude Code-style config, so an entry in ~/.grok/config.toml or a project .mcp.json works the same way.

3. Authenticate

Composio uses OAuth. In the /mcps modal, select the Composio server and press i to authenticate (Grok also triggers this browser flow automatically the first time it uses a Composio tool). Click Allow to authorize access. Grok stores the tokens under ~/.grok/mcp_credentials.json, and /mcps shows Composio as connected.

Grok Build prompting to authenticate the Composio MCP server Composio authorization screen with the Allow button for Grok Build

4. Start building

Ask Grok to work with your Zoho mail account through Composio. On the first Zoho mail action, Composio prompts you to connect the account through OAuth. Approve the scopes once, and Composio handles token refresh from there.

What you can do after connecting Zoho mail

  • Send a follow-up email to yesterday's meeting attendees
  • List unread emails from your manager
  • Schedule a calendar event from an email
  • Archive all newsletters received this week

Security + privacy notes (important)

  • Use least-privilege access. Grant only the Zoho mail scopes you actually need.
  • Review OAuth scopes before approving. Check that the requested scopes match what you expect Composio and Grok Build to do.
  • Keep write actions human-reviewed. Grok Build proposes a plan before it acts. Leave that approval step on for actions like sending messages or editing records.
  • Keep secrets out of version control. Your XAI_API_KEY and any tokens should never be committed. Use environment variables or a secrets manager.
TOOLS

Supported Tools

Every Zoho mail action and event your agent gets out of the box.

Create Signature

Create a signature, optionally assign it to users, and return it.

Get Signatures

List all connected-user signatures or retrieve one signature by ID.

List Zoho Mail Accounts

Retrieves all Zoho Mail accounts associated with the authenticated user.

Update Account Display Name

Update the display name of a Zoho Mail account owned by the user.

Delete Label

Delete a label and remove it from associated Zoho Mail messages.

Create Folder

Create a folder in a Zoho Mail account and return its folder record.

Delete Folder

Delete a folder from a Zoho Mail account.

Get Folder

Retrieve one Zoho Mail folder by account and folder ID.

List Folders

List every folder in a Zoho Mail account.

Update Folder

Rename or move a Zoho Mail folder, or enable or disable its IMAP visibility, and return its observed state from a follow-up read.

Delete Groups in Bulk

Delete multiple groups in a single API call.

Delete Group

Tool to delete a specific mail group by its zgid.

Get Organization Group

Retrieve one Zoho Mail organization group, including members and settings.

List Moderated Messages

List messages held for moderation in one Zoho Mail organization group.

Moderate Messages

Release held group messages for delivery or permanently reject them.

Create Label

Create a label in a Zoho Mail account and return its identifiers.

List Labels

List every label configured in a Zoho Mail account.

List Bookmarks

Tool to retrieve all personal bookmarks from a Zoho Mail account.

List Organization Accounts

List one offset-paginated page of accounts managed by a Zoho organization.

List Organization Domains

List mail domains configured for a Zoho Mail organization.

Manage Domain Addresses

Add or permanently remove domain aliases, catch-all delivery, and notification addresses.

Manage Domain DKIM

Add, verify, regenerate, default, or delete a domain DKIM selector.

Manage Domain Hosting

Set a primary domain or enable/disable mail hosting and subdomain stripping.

Create Email Draft

Tool to create and save an email draft in Zoho Mail without sending it.

Delete Email

Move one Zoho Mail email to trash or permanently delete it.

Download Attachment

Download one attachment from a Zoho Mail message as a file.

Get Attachment Info

Get normal and optional inline attachment metadata for one message.

Get Message Content

Tool to retrieve the full content/body of a specific Zoho Mail email.

Get Message Headers

Get one email's internet message headers without flattening repeated values.

Get Message Metadata

Retrieve one email's complete metadata record by account, folder, and message ID.

List Emails

Tool to retrieve a list of emails from a Zoho Mail account folder.

Reply to Email

Send or schedule a reply while preserving the original message thread.

Send Email

Send an email immediately or schedule it for later delivery.

Update Messages

Batch-update message or thread read, folder, flag, label, archive, or spam state.

Get Organization User Storage Details

Tool to retrieve storage details for a specific user in the organization.

Update Organization Spam Process Type

Tool to update organization spam processing type.

Update User Storage

Updates a user's storage allocation within a Zoho Mail organization.

Search Messages

Tool to search emails in a Zoho Mail account using Zoho's searchKey syntax.

Create Group Task

Create a task in a Zoho Mail group.

Create Personal Task

Create a personal task for the connected Zoho Mail user.

List Personal Tasks

List one offset-paginated page of personal tasks for the connected Zoho Mail user.

Update Group Task

Update one documented field on a task in a Zoho Mail group.

Update Group Settings

Tool to update group settings.

Update Organization Account

Enable or disable an external account, or update incoming, outgoing, IMAP, POP, or ActiveSync status for an organization-managed mailbox.

Verify Domain Records

Verify domain ownership, SPF, or MX DNS records for a Zoho Mail domain.

FAQ

Frequently asked questions

Start with Zoho mail.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Zoho mail tool your agent needs.Free to start.

Start building