Zoho Mail MCP Server
Integrates with Zoho Mail API to provide email management (send, receive, search, organize), organization administration (domains, users, groups), and productivity tools (tasks, bookmarks, notes) for Zoho Mail accounts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zoho Mail MCP Server Send an email to alice@example.com about project update"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zoho Mail MCP Server
A comprehensive Model Context Protocol (MCP) server for integrating with Zoho Mail API, providing seamless email management, organization administration, and productivity features through AI assistants like Claude.
🚀 Features
Core Email Functions
Send & Receive: Send emails with/without attachments, list and search emails
Email Management: Mark as read/unread, move between folders, delete emails
Content Access: Get full email content and manage email threads
Organization Management
Domain Management: Add, verify, and manage domains with DNS settings
User Administration: Add users, manage permissions and storage limits
Security: IP allowlists, spam management, and audit logging
Productivity Tools
Folders & Labels: Create and organize email folders and labels
Tasks: Manage group and personal tasks
Bookmarks: Save and organize important links
Notes: Create and manage notes within groups
Advanced Features
Multi-region Support: Automatically adapts to different Zoho regions (.com, .in, .eu, etc.)
Structured Responses: All API responses are structured with consistent error handling
Comprehensive Logging: Detailed logging for debugging and monitoring
Related MCP server: Zoho Mail MCP Server
📋 Prerequisites
Python 3.8 or higher
Nango account with Zoho Mail integration configured
Zoho Mail account with appropriate permissions
🛠️ Installation
Clone the repository
git clone <repository-url> cd zoho-mail-mcp-serverInstall dependencies
pip install -r requirements.txtSet up environment variables Create a
.envfile in the project root:NANGO_CONNECTION_ID=your_connection_id NANGO_INTEGRATION_ID=your_integration_id NANGO_BASE_URL=https://api.nango.dev NANGO_SECRET_KEY=your_nango_secret_key
⚙️ Configuration
Nango Setup
Create a Nango Account
Visit Nango and create an account
Set up a new integration for Zoho Mail
Configure Zoho Mail Integration
In Nango dashboard, create a new Zoho Mail integration
Configure the required scopes:
ZohoMail.messages.ALLZohoMail.folders.ALLZohoMail.accounts.READZohoMail.organization.ALL(for admin functions)
Get Connection Details
Create a connection in Nango
Note down your connection ID, integration ID, and secret key
Ensure your connection config includes the correct extension (e.g.,
{'extension': 'in'})
Environment Variables
Variable | Description | Required |
| Your Nango connection identifier | ✅ |
| Your Nango integration identifier | ✅ |
| Nango API base URL | ✅ |
| Your Nango secret key | ✅ |
🚀 Usage
Starting the Server
python zoho_mail_mcp.pyThe server will start and automatically detect your Zoho region based on your Nango configuration.
Using with Claude Desktop
Add to Claude Desktop Configuration
Edit your Claude Desktop config file (usually located at
~/.claude/claude_desktop_config.json):{ "mcpServers": { "zoho-mail": { "command": "python", "args": ["/path/to/your/zoho_mail_mcp.py"], "env": { "NANGO_CONNECTION_ID": "your_connection_id", "NANGO_INTEGRATION_ID": "your_integration_id", "NANGO_BASE_URL": "https://api.nango.dev", "NANGO_SECRET_KEY": "your_nango_secret_key" } } } }Restart Claude Desktop
Start Using
You can now use natural language commands with Claude:
"Send an email to john@example.com with subject 'Meeting Tomorrow'" "List my recent emails" "Create a new folder called 'Projects'" "Show me all users in my organization"
📚 Available Functions
Authentication
get_nango_auth_info()- Get current authentication status and user info
Email Management
send_email()- Send email with basic optionssend_email_with_attachments()- Send email with file attachmentslist_emails()- List emails in account or specific foldersearch_emails()- Search emails with custom parametersget_email_content()- Get full email contentmark_emails_as_read()/mark_emails_as_unread()- Change read statusmove_emails()- Move emails between foldersdelete_email()- Delete specific email
Folder & Label Management
create_folder()/delete_folder()- Manage email foldersget_all_folders()/get_folder_details()- Retrieve folder informationcreate_label()/update_label()/delete_label()- Manage email labels
Organization Management
get_organization_details()- Get organization informationadd_domain()/verify_domain()- Domain managementadd_user()/get_all_users()- User administrationcreate_group()/get_all_groups()- Group management
Security & Compliance
add_allowed_ips()/get_allowed_ips()- IP allowlist managementget_login_history()- Access login audit logsget_audit_records()- Get detailed audit records
Productivity Tools
add_task()/get_all_tasks_in_group()- Task managementcreate_bookmark()/get_all_bookmarks()- Bookmark managementcreate_note()/edit_note()- Note management
🌍 Multi-Region Support
The server automatically detects your Zoho region from Nango configuration:
Global (.com):
https://mail.zoho.com/apiIndia (.in):
https://mail.zoho.in/apiEurope (.eu):
https://mail.zoho.eu/apiChina (.com.cn):
https://mail.zoho.com.cn/api
No manual configuration needed - the server adapts automatically!
🔧 Troubleshooting
Common Issues
1. Authentication Errors
Error: Authentication failed: No access token foundVerify your Nango environment variables are correct
Check that your Nango connection is active and not expired
Ensure your Zoho Mail integration has the required scopes
2. Wrong Region/Extension
Error: HTTP 404: Not FoundCheck your Nango connection config includes the correct extension
Verify you're using the right Zoho region for your account
3. Permission Errors
Error: HTTP 403: ForbiddenEnsure your Zoho account has the necessary permissions
For organization functions, you need admin privileges
Check that required scopes are granted in Nango
Debug Mode
Enable detailed logging by setting the log level:
logging.basicConfig(level=logging.DEBUG)Testing Connection
Use the authentication info function to test your setup:
# This will show your current auth status
auth_info = get_nango_auth_info()
print(f"Connected as: {auth_info.user_email}")
print(f"Region: {auth_info.extension}")
print(f"Scopes: {auth_info.scopes}")📖 API Response Format
All functions return structured ApiResponse objects:
{
"success": bool, # Whether operation succeeded
"data": dict, # Response data from Zoho API
"error": str, # Error message if any
"status_code": int # HTTP status code
}🤝 Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
Issues: Open an issue on GitHub for bugs or feature requests
Documentation: Check the Zoho Mail API Documentation
Nango Help: Visit Nango Documentation for authentication issues
🏗️ Roadmap
Real-time email notifications via webhooks
Email template management
Advanced search filters
Bulk operations support
Calendar integration
Mobile push notifications setup
Made with ❤️ for seamless Zoho Mail integration
Available Tools
78 toolsadd_allowed_ipsC
Add allowed IP range for organization.
Inputs: zoid (required), role_id (required), to_ip_range (required), from_ip_range (required). Returns: Standard API response structure.
add_catch_all_addressC
Add catch-all address for domain.
Inputs: zoid (required), domain_name (required), catch_all_address (required). Returns: Standard API response structure.
add_child_organizationC
Add a child organization to a partner portal.
Inputs: admin_email (required), domain_name (required), organization_name (required). Returns: Standard API response structure.
add_dkim_detailsC
Add DKIM details to domain.
Inputs: zoid (required), selector (required), domain_name (required), key_size, +1 more. Returns: Standard API response structure.
add_domainC
Add domain to organization.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
add_domain_aliasC
Add domain alias.
Inputs: zoid (required), domain_name (required), domain_alias (required). Returns: Standard API response structure.
add_notification_addressC
Add notification address for domain.
Inputs: zoid (required), domain_name (required), notification_address (required). Returns: Standard API response structure.
add_taskC
Add a new group/personal task.
Inputs: zgid (required), task_data (required). Returns: Standard API response structure.
add_userC
Add user to organization.
Inputs: zoid (required), user_data (required). Returns: Standard API response structure.
create_bookmarkD
Create a bookmark.
Inputs: group_id (required), bookmark_data (required). Returns: Standard API response structure.
create_folderC
Create a new folder.
Inputs: account_id (required), folder_data (required). Returns: Standard API response structure.
create_groupC
Create a new group.
Inputs: zoid (required), group_data (required). Returns: Standard API response structure.
create_labelC
Create a new label.
Inputs: account_id (required), display_name (required), color. Returns: Standard API response structure.
create_noteC
Create a new note.
Inputs: group_id (required), note_data (required). Returns: Standard API response structure.
delete_allowed_ipsC
Delete allowed IP range for organization.
Inputs: zoid (required), role_id (required), to_ip_range (required), from_ip_range (required), +1 more. Returns: Standard API response structure.
delete_bookmarkC
Delete a bookmark.
Inputs: group_id (required), bookmark_id (required). Returns: Standard API response structure.
delete_catch_all_addressC
Delete catch-all address.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
delete_dkim_detailD
Delete DKIM detail.
Inputs: zoid (required), dkim_id (required), domain_name (required). Returns: Standard API response structure.
delete_domainC
Remove domain from organization.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
delete_emailD
Delete an email.
Inputs: folder_id (required), account_id (required), message_id (required), expunge. Returns: Standard API response structure.
delete_folderC
Delete a folder.
Inputs: folder_id (required), account_id (required). Returns: Standard API response structure.
delete_labelC
Delete a label.
Inputs: label_id (required), account_id (required). Returns: Standard API response structure.
delete_noteD
Delete a note.
Inputs: note_id (required), group_id (required). Returns: Standard API response structure.
delete_notification_addressC
Delete notification address.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
delete_taskC
Delete a group/personal task.
Inputs: zgid (required), task_id (required). Returns: Standard API response structure.
disable_subdomain_strippingD
Disable sub-domain stripping.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
edit_noteD
Edit a note.
Inputs: note_id (required), group_id (required), note_data (required). Returns: Standard API response structure.
enable_email_hostingC
Enable email hosting for domain.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
enable_subdomain_strippingD
Enable sub-domain stripping.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
get_account_detailsC
Get specific account details.
Inputs: account_id (required). Returns: Standard API response structure.
get_all_accountsA
Get all accounts of authenticated user.
Inputs: no named parameters. Returns: Standard API response structure.
get_all_bookmarksB
Get all bookmarks in group.
Inputs: group_id (required). Returns: Standard API response structure.
get_all_domainsC
Fetch all domains in organization.
Inputs: zoid (required). Returns: Standard API response structure.
get_all_foldersC
Get all folders in account.
Inputs: account_id (required). Returns: Standard API response structure.
get_all_groupsB
Get all groups in organization.
Inputs: zoid (required). Returns: Standard API response structure.
get_all_labelsC
Get all label details.
Inputs: account_id (required). Returns: Standard API response structure.
get_all_notesB
Get all notes in group.
Inputs: group_id (required). Returns: Standard API response structure.
get_allowed_ipsC
Get list of allowed IP ranges for organization.
Inputs: zoid (required). Returns: Standard API response structure.
get_all_tasks_in_groupC
Get all tasks in a group/personal tasks.
Inputs: zgid (required), status. Returns: Standard API response structure.
get_all_usersC
Get all organization users details.
Inputs: zoid (required). Returns: Standard API response structure.
get_audit_recordsC
Get audit records for organization.
Inputs: zoid (required), limit, end_time, search_key, +3 more. Returns: Standard API response structure.
get_bookmark_detailsC
Get bookmark details.
Inputs: group_id (required), bookmark_id (required). Returns: Standard API response structure.
get_domain_detailsC
Get specific domain details.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
get_email_contentC
Get email content.
Inputs: folder_id (required), account_id (required), message_id (required), include_block_content. Returns: Standard API response structure.
get_folder_detailsB
Get specific folder details.
Inputs: folder_id (required), account_id (required). Returns: Standard API response structure.
get_group_detailsC
Get specific group details.
Inputs: zgid (required), zoid (required). Returns: Standard API response structure.
get_label_detailsC
Get specific label details.
Inputs: label_id (required), account_id (required). Returns: Standard API response structure.
get_login_historyC
Get login history for organization.
Inputs: mode (required), zoid (required), to_time (required), from_time (required), +3 more. Returns: Standard API response structure.
get_nango_auth_infoB
Get current Nango authentication information.
Inputs: no named parameters. Returns: Nango authentication information structure.
get_note_detailsC
Get details of a specific note.
Inputs: note_id (required), group_id (required). Returns: Standard API response structure.
get_organization_detailsC
Get details of a child organization.
Inputs: zoid (required). Returns: Standard API response structure.
get_organization_subscription_detailsC
Get organization subscription and storage details.
Inputs: zoid (required). Returns: Standard API response structure.
get_spam_listing_infoC
Get organization spam listing information.
Inputs: zoid (required), spam_category (required), limit, start. Returns: Standard API response structure.
get_specific_taskC
Get specific task details.
Inputs: zgid (required), task_id (required). Returns: Standard API response structure.
get_user_detailsC
Get specific user details.
Inputs: zoid (required), zuid (required), email_address. Returns: Standard API response structure.
get_user_storage_detailsC
Get user storage details.
Inputs: zoid (required), zuid (required). Returns: Standard API response structure.
list_emailsC
List emails in account or folder.
Inputs: account_id (required), limit, start, folder_id. Returns: Standard API response structure.
mark_emails_as_readC
Mark emails as read.
Inputs: account_id (required), thread_ids, message_ids. Returns: Standard API response structure.
mark_emails_as_unreadC
Mark emails as unread.
Inputs: account_id (required), thread_ids, message_ids. Returns: Standard API response structure.
move_emailsC
Move emails to different folder.
Inputs: account_id (required), dest_folder_id (required), folder_id, is_archive, +3 more. Returns: Standard API response structure.
regenerate_dkim_keyC
Regenerate DKIM public key.
Inputs: zoid (required), dkim_id (required), domain_name (required). Returns: Standard API response structure.
remove_domain_aliasC
Remove domain alias.
Inputs: zoid (required), domain_name (required), domain_alias (required). Returns: Standard API response structure.
remove_spam_listingC
Remove organization spam listing info.
Inputs: zoid (required), spam_data (required). Returns: Standard API response structure.
rename_folderC
Rename a folder.
Inputs: folder_id (required), account_id (required), folder_name (required). Returns: Standard API response structure.
search_emailsC
Search emails based on parameters.
Inputs: account_id (required), search_key (required), limit, start. Returns: Standard API response structure.
send_emailC
Send an email.
Inputs: content (required), subject (required), account_id (required), to_address (required), +6 more. Returns: Standard API response structure.
send_email_with_attachmentsC
Send email with attachments.
Inputs: content (required), subject (required), account_id (required), to_address (required), +5 more. Returns: Standard API response structure.
set_default_dkimC
Set DKIM detail as default.
Inputs: zoid (required), dkim_id (required), domain_name (required). Returns: Standard API response structure.
set_primary_domainC
Set domain as primary domain.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
update_labelD
Update label details.
Inputs: label_id (required), account_id (required), color, display_name. Returns: Standard API response structure.
update_spam_listingC
Add or update organization spam listing info.
Inputs: zoid (required), spam_data (required). Returns: Standard API response structure.
update_spam_process_typeC
Update organization spam processing type.
Inputs: zoid (required), spam_config (required). Returns: Standard API response structure.
update_task_titleC
Change task title.
Inputs: zgid (required), title (required), task_id (required). Returns: Standard API response structure.
update_user_storageC
Update storage limit for a user.
Inputs: zoid (required), zuid (required), storage_limit (required). Returns: Standard API response structure.
verify_dkim_keyC
Verify DKIM public key.
Inputs: zoid (required), dkim_id (required), domain_name (required). Returns: Standard API response structure.
verify_domainC
Verify domain using specified method.
Inputs: mode (required), zoid (required), domain_name (required). Returns: Standard API response structure.
verify_mx_recordC
Verify MX record for domain.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
verify_spf_recordC
Verify SPF record for domain.
Inputs: zoid (required), domain_name (required). Returns: Standard API response structure.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 78 tools
Most tools target distinct resource-action pairs with clear boundaries, such as domain verification, DKIM management, email operations, and notes. However, send_email and send_email_with_attachments could be conflated, and a few admin tools like get_user_storage_details and get_account_details have somewhat overlapping scope.
The majority of tools follow a clear verb_noun snake_case pattern, such as get_all_domains, add_domain, delete_label, and verify_mx_record. Minor inconsistencies exist with mix of add_ vs create_ for similar actions and update_task_title vs edit_note vs rename_folder, but these are readable and predictable.
With 78 tools, this server is heavily overloaded, far exceeding the typical well-scoped MCP server range. It attempts to cover organization administration, domain management, email, users, groups, tasks, bookmarks, notes, and more in a single surface, making it unwieldy for agents.
Core email workflows are well covered with send, list, search, get, move, delete, folders, and labels. However, user and group management are incomplete (no update/delete), bookmarks lack an update operation, and tasks only support title changes rather than broader task lifecycle management.
Related MCP Connectors
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, search, send, and reply to Zoho Mail via IMAP/SMTP using an application-specific password.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides full access to Zoho Mail accounts, enabling email search, read, send, reply, thread management, folder/label operations, and more via 14 tools.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, send, search, reply to, and delete emails directly from a Zoho Mail account.8MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to one or more Zoho Mail accounts, enabling read, send, search, reply, and delete operations directly from an AI workflow. Multiple mailboxes can run from a single lightweight process to reduce memory usage.MIT