Zoho Mail MCP Server
Provides tools to access and manage Zoho Mail account, including reading, searching, sending, and organizing emails, folders, labels, and drafts.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Zoho Mail MCP Server
MCP server for Zoho Mail — gives Claude (and any MCP client) full access to your Zoho Mail account via 14 tools.
Tools
Tool | Description | Safety |
| Get account profile | Read-only |
| Search emails by query | Read-only |
| Read a specific email | Read-only |
| Read an email thread | Read-only |
| List mail folders | Read-only |
| List labels/tags | Read-only |
| List saved drafts | Read-only |
| Get attachment metadata | Read-only |
| Create a draft | Write (non-destructive) |
| Send an existing draft | Write (destructive) |
| Send an email | Write (destructive) |
| Reply / reply-all | Write (destructive) |
| List sends waiting in the Outbox (graceMinutes) | Read |
| Pull back a scheduled send before it is released | Write (reversible) |
| Mark read/star/move | Write (destructive, idempotent) |
| Delete (trash) an email | Write (destructive, idempotent) |
All tools carry MCP ToolAnnotations with readOnlyHint, destructiveHint, idempotentHint, and openWorldHint set appropriately.
Related MCP server: Zoho Mail MCP
Usage Examples
Example 1: Search and read recent emails
Prompt: "Show me my most recent emails"
The assistant calls zoho_search_messages with default parameters to retrieve the latest 20 messages, then summarizes senders, subjects, and dates.
Example 2: Send an email
Prompt: "Send an email to alice@example.com with the subject 'Project Update' and let her know the deadline moved to Friday"
The assistant calls zoho_send_message with:
to: "alice@example.com"subject: "Project Update"body: "Hi Alice, just a heads-up — the project deadline has moved to Friday. Let me know if you have questions."
Example 3: Find and reply to a thread
Prompt: "Find the email thread from Bob about the budget and reply saying I approve"
The assistant calls zoho_search_messages with q: "from:bob subject:budget", reads the thread with zoho_read_thread, then calls zoho_reply_to_message with the body "Approved — looks good to me."
Example 4: Organize messages
Prompt: "Star all unread emails from my manager and mark them as read"
The assistant calls zoho_search_messages to find unread messages from the manager, then calls zoho_modify_message on each with isRead: true and isStarred: true.
Setup
1. Zoho OAuth Credentials
Go to Zoho API Console
Create a Self Client
Generate a grant code with scopes:
ZohoMail.messages.ALL,ZohoMail.folders.ALL,ZohoMail.tags.ALL,ZohoMail.accounts.READ,ZohoMail.attachments.READExchange the grant code for a refresh token
Copy your Client ID, Client Secret, and Refresh Token
2. Configure
cp env.example .env
# Edit .env with your credentials3. Install & Run
Standalone:
pip install -r requirements.txt
python server.pyDocker:
docker compose up --build4. Connect to Claude
Add to your Claude MCP config (~/.claude/claude_desktop_config.json or Claude.ai settings):
{
"mcpServers": {
"zoho-mail": {
"command": "python",
"args": ["/path/to/zoho-mail-mcp/server.py"],
"env": {
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}Testing
pip install pytest pytest-asyncio respx
pytest tests/ -vData Centers
Set ZOHO_MAIL_BASE_URL and ZOHO_ACCOUNTS_URL for your region:
Region | Mail URL | Accounts URL |
US |
|
|
EU |
|
|
India |
|
|
Australia |
|
|
Japan |
|
|
Privacy Policy
This MCP server acts as a local bridge between your MCP client (Claude, etc.) and the Zoho Mail API. It does not collect, store, transmit, or log any user data beyond what is required for OAuth token management (refresh token stored in your local .env file). No data is sent to any third party. All API calls go directly from your machine to Zoho's servers using your own OAuth credentials. No telemetry, analytics, or tracking of any kind is included.
Support
File issues at github.com/ludoplex/zoho-mail-mcp/issues.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…
Search Gmail and Outlook, save drafts, manage email rules, and view email stats.
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive Gmail management with 17 tools for searching, sending, and organizing emails, managing labels, threads, drafts, and attachments through the Gmail API.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, search, send, and reply to Zoho Mail via IMAP/SMTP using an application-specific password.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, send, search, reply to, and delete emails directly from a Zoho Mail account.8MIT
- FlicenseCqualityDmaintenanceEnables AI assistants to manage Zoho Mail accounts, including sending/receiving emails, folder and label management, organization administration, and productivity tools like tasks and notes.782-