Your Zoho mailbox, available to any AI assistant.
An MCP server for Zoho Mail, Calendar and Contacts — plus Tasks, Notes,
Bookmarks, Groups and Resource Booking. Works with Claude, ChatGPT, Gemini,
or anything else that speaks the Model Context Protocol.
Get started
View source
Runs locally on your machine. Sending email is off by default.
What it reaches
- Mail
- Calendar
- Contacts
- Tasks
- Notes
- Bookmarks
- Groups
- Resource Booking
Reading and writing both — search and triage mail, draft replies and
forwards, schedule and update events, look people up, capture tasks and
notes.
Three things it refuses to compromise on
It stays on your machine
Local stdio transport, launched by your own MCP client. There is no
hosted service in the middle, no relay, and no third party holding a
token to your mailbox. Your mail goes between your computer and Zoho,
and nowhere else. One opt-in setting lets it ask GitHub whether a
newer version exists; that is the only call to any other host, it is
off unless you turn it on, and it sends nothing but the question.
Sending is off by default
Ask an assistant to send mail and, unless you have turned sending on,
it lands in Drafts for you to review — nothing leaves your account.
Turning it on is a deliberate act by a person at a settings pane, and
the switch is read once when the server starts, so nothing inside a
conversation can reach it. Replies and forwards stop at Drafts at
every setting, because both quote an incoming email, and email bodies
are untrusted input that can try to talk an assistant into sending
something on your behalf.
It was verified against a real account
Every tool was run against a live Zoho account rather than built from
the documentation. That distinction earned its keep: required fields
documented as optional, fields whose names contradict their contents,
endpoints listed at URLs that return 404. Where the API disagrees with
its own docs, the repository records what it actually does.
Why not Zoho's own MCP server?
Zoho ships a first-party MCP offering covering Mail, Calendar and dozens of
other products. It's hosted, organization-oriented and broad. If you
need CRM or Desk, or you need several people on one shared server, use
theirs.
This one is narrow on purpose: local, with no third-party relay;
draft-first mail composition; and every date and time already converted to
your mailbox's own local offset, so no assistant has to get the arithmetic
right. It also reaches Zoho Contacts, and Mail's Tasks, Notes and
Bookmarks — ground the pre-configured servers don't cover.
Read the full comparison →
Install
You'll need uv and a Zoho account.
-
Register an application
Create a Server-based Application in the
Zoho API Console
and set its redirect URI to the local callback address. This gives you a
client id and secret.
-
Run the one-time auth flow
It opens your browser so you can approve access, then stores the
refresh token in your operating system's credential store — not in a
file, and never in a conversation.
uv run zoho-mcp-setup
-
Point your client at it
Setup prints a ready-to-paste configuration block. Drop it into your
MCP client's config and restart. For Claude Desktop there's a packaged
extension that replaces this with a settings form.
Full setup notes, the tool reference and every configuration option live in
the README.