# Zoho Mail — how to use (mcp.ai)

Connect your Zoho Mail account and use 15 tools for email straight from your AI agent. Connect in one click, no API key needed. Zoho Mail is a secure and ad-free email hosting platform with collaboration tools, calendar integration, and extensive administrative controls.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zoho_mail?ms=1787298780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zoho_mail_accounts_list_accounts`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zoho_mail`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zoho_mail/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zoho_mail/accounts/list/accounts` — Retrieves all Zoho Mail accounts associated with the authenticated user. Returns account details including accountId (required for other mail operations), email addresses, storage information, account
  - body: { region?: string, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/domain/operations` — Tool to perform domain operations like verify, set primary domain, hosting, aliases, MX/SPF checks, DKIM management, and notifications. Use after creating or retrieving a domain.
  - body: { mode: string, zoid: integer, dkimId?: integer, region?: string, keySize?: integer, selector?: string, isDefault?: boolean, domainName: string, domainAlias?: string, accept_language?: string, catchAllAddress?: string, use_bearer_auth?: boolean, notificationAddress?: string }
- `POST https://api.mcp.ai/api/zoho_mail/get/all/bookmarks` — Tool to retrieve all personal bookmarks from a Zoho Mail account. Use when you need to fetch saved bookmarks/links with support for pagination and field filtering.
  - body: { after?: string, limit?: integer, fields?: string, region?: string, is_prev?: boolean, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/groups/delete/group/bulk` — Delete multiple groups in a single API call. This action permanently removes the specified groups from your Zoho Mail organization. Use this when you need to: - Remove multiple obsolete or unused grou
  - body: { zoid: integer, region?: string, groupList: integer[], accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/groups/delete/group/by/zgid` — Tool to delete a specific mail group by its zgid. Use when you need to remove a group from your organization after confirming the IDs.
  - body: { zgid: integer, zoid: integer, region?: string, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/messages/create/draft` — Tool to create and save an email draft in Zoho Mail without sending it. Use when composing emails that need to be saved for later editing or sending.
  - body: { mode?: string, region?: string, content?: string, subject?: string, encoding?: string, accountId: string, ccAddress?: string, toAddress: string, askReceipt?: string, bccAddress?: string, mailFormat?: string, fromAddress: string, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/messages/get/message/content` — Tool to retrieve the full content/body of a specific Zoho Mail email. Use when you need to fetch the complete email content after listing or searching messages, as list/search endpoints typically retu
  - body: { region?: string, folder_id: string, account_id: string, message_id: string, accept_language?: string, use_bearer_auth?: boolean, include_block_content?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/messages/list/emails` — Tool to retrieve a list of emails from a Zoho Mail account folder. Use when you need to fetch emails from inbox or specific folder, with support for filtering by read status, attachments, flags, and p
  - body: { limit?: integer, start?: integer, region?: string, status?: string, flagged?: boolean, sort_by?: string, folder_id?: string, account_id: string, search_key?: string, sort_order?: boolean, threaded_mails?: boolean, accept_language?: string, only_attachment?: boolean, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/messages/reply/to/email` — Tool to reply to an existing email via Zoho Mail API. Use when you need to send a reply to a received email message, maintaining email threading.
  - body: { region?: string, content: string, subject?: string, encoding?: string, timeZone?: string, accountId: string, ccAddress?: string, messageId: string, toAddress: string, askReceipt?: string, bccAddress?: string, isSchedule?: boolean, mailFormat?: string, fromAddress: string, scheduleTime?: string, scheduleType?: integer, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/messages/send/email` — Tool to send an email via Zoho Mail API. Use when you need to send emails immediately to recipients.
  - body: { region?: string, content: string, subject: string, encoding?: string, isInline?: boolean, timeZone?: string, accountId: string, ccAddress?: string, toAddress: string, askReceipt?: string, attachment?: object|object[], bccAddress?: string, isSchedule?: boolean, mailFormat?: string, fromAddress: string, scheduleTime?: string, scheduleType?: integer, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/organization/get/user/storage/details` — Tool to retrieve storage details for a specific user in the organization. Use when you need to know a user’s total and used storage quotas.
  - body: { zoid: integer, zuid: integer, region?: string, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/organization/update/spam/process/type` — Tool to update organization spam processing type. Use when changing the spam filtering strategy for an organization.
  - body: { mode?: string, zoid: integer, region?: string, spamVO: object, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/organization/update/user/storage` — Updates a user's storage allocation within a Zoho Mail organization. Can modify either base storage plan or extra storage add-ons. Use this when you need to: - Change a user's base storage plan (e.g.,
  - body: { mode: string, zoid: integer, zuid: integer, region?: string, plan_type?: string, addon_type?: string[], accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/search/messages` — Tool to search emails in a Zoho Mail account using Zoho's searchKey syntax. Use when you need to find specific emails by sender, subject, keywords, status (e.g., unread), attachments, or flags. Return
  - body: { limit?: integer, start?: integer, region?: string, includeto?: boolean, account_id: string, search_key: string, received_time?: integer, accept_language?: string, use_bearer_auth?: boolean }
- `POST https://api.mcp.ai/api/zoho_mail/update/group/settings` — Tool to update group settings. Use after group creation to adjust general or text settings.
  - body: { mode: string, zgid: integer, zoid: integer, region?: string, accept_language?: string, use_bearer_auth?: boolean, groupTextSettings?: object, groupGeneralSettings?: object }

## Example prompts
- "What can I do in Zoho Mail?"
- "Show me a summary of my Zoho Mail account"

## More
- Page: https://mcp.ai/zoho_mail
- Agent spec (llms.txt): https://mcp.ai/zoho_mail/llms.txt
- Postman collection: https://mcp.ai/zoho_mail/postman.json