zoho-mcp

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

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.

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

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