SirGreed808/zoho-mail-mcp

A Model Context Protocol server for Zoho Mail. Lets Claude (or any MCP client) read, search, and send email from a Zoho Mail account without browser automation.
No equivalent exists in the official MCP registry — this fills that gap.
Tools
| Tool | Description |
|------|-------------|
| list_inbox | List recent inbox messages — returns sender, subject, date, messageId, folderId |
| search_emails | Search by keyword, sender email, or subject fragment |
| read_email | Read full email body given a messageId and folderId |
| send_email | Send an email from your configured sender address |
Prerequisites
- A Zoho Mail account
- Node.js 18+
Setup
1. Create a Zoho OAuth app
1. Go to Zoho API Console
2. Create a **Self Client** application
3. Under **Generate Code**, add these scopes:
4. Set expiry to **10 minutes**, add a description, click **Create**
5. Copy the generated client_id, client_secret, and grant code
2. Exchange the grant code for a refresh token
Run immediately (grant code expires in 10 minutes):
Save the refresh_token from the response — it doesn't expire.
3. Get your account ID
Use the accountId value from the first object in data[].
4. Install
5. Add to Claude Code
ZOHO_SENDER must be a verified address or alias on the account.
Environment Variables
| Variable | Description |
|----------|-------------|
| ZOHO_CLIENT_ID | OAuth app client ID |
| ZOHO_CLIENT_SECRET | OAuth app client secret |
| ZOHO_REFRESH_TOKEN | Long-lived refresh token (from step 2) |
| ZOHO_ACCOUNT_ID | Zoho Mail account ID (from step 3) |
| ZOHO_SENDER | Email address to send from |
Notes
- Access tokens are refreshed automatically — no manual intervention needed
- read_email requires both messageId and folderId, both returned by list_inbox and search_emails