Skip to main content
Glama
Zoho Mail MCP Server

Zoho Mail MCP Server

by ampcome-mcps

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

  1. Clone the repository

    git clone <repository-url>
    cd zoho-mail-mcp-server
  2. Install dependencies

    pip install -r requirements.txt
  3. Set up environment variables Create a .env file 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

  1. Create a Nango Account

    • Visit Nango and create an account

    • Set up a new integration for Zoho Mail

  2. Configure Zoho Mail Integration

    • In Nango dashboard, create a new Zoho Mail integration

    • Configure the required scopes:

      • ZohoMail.messages.ALL

      • ZohoMail.folders.ALL

      • ZohoMail.accounts.READ

      • ZohoMail.organization.ALL (for admin functions)

  3. 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

NANGO_CONNECTION_ID

Your Nango connection identifier

✅

NANGO_INTEGRATION_ID

Your Nango integration identifier

✅

NANGO_BASE_URL

Nango API base URL

✅

NANGO_SECRET_KEY

Your Nango secret key

✅

🚀 Usage

Starting the Server

python zoho_mail_mcp.py

The server will start and automatically detect your Zoho region based on your Nango configuration.

Using with Claude Desktop

  1. 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"
          }
        }
      }
    }
  2. Restart Claude Desktop

  3. 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 options

  • send_email_with_attachments() - Send email with file attachments

  • list_emails() - List emails in account or specific folder

  • search_emails() - Search emails with custom parameters

  • get_email_content() - Get full email content

  • mark_emails_as_read() / mark_emails_as_unread() - Change read status

  • move_emails() - Move emails between folders

  • delete_email() - Delete specific email

Folder & Label Management

  • create_folder() / delete_folder() - Manage email folders

  • get_all_folders() / get_folder_details() - Retrieve folder information

  • create_label() / update_label() / delete_label() - Manage email labels

Organization Management

  • get_organization_details() - Get organization information

  • add_domain() / verify_domain() - Domain management

  • add_user() / get_all_users() - User administration

  • create_group() / get_all_groups() - Group management

Security & Compliance

  • add_allowed_ips() / get_allowed_ips() - IP allowlist management

  • get_login_history() - Access login audit logs

  • get_audit_records() - Get detailed audit records

Productivity Tools

  • add_task() / get_all_tasks_in_group() - Task management

  • create_bookmark() / get_all_bookmarks() - Bookmark management

  • create_note() / edit_note() - Note management

🌍 Multi-Region Support

The server automatically detects your Zoho region from Nango configuration:

  • Global (.com): https://mail.zoho.com/api

  • India (.in): https://mail.zoho.in/api

  • Europe (.eu): https://mail.zoho.eu/api

  • China (.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 found
  • Verify 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 Found
  • Check 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: Forbidden
  • Ensure 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

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🏗️ 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 tools
add_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

    C2.5/5.0

    Scored across 78 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read, search, send, and reply to Zoho Mail via IMAP/SMTP using an application-specific password.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides full access to Zoho Mail accounts, enabling email search, read, send, reply, thread management, folder/label operations, and more via 14 tools.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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