Zoho Mail

Email and calendar

Zoho Mail for AI agents. Find the message behind the answer.

Search a user’s Zoho Mail account and read selected messages. Give your agent the email context it needs for briefings and reply preparation.

About Zoho Mail

With the Zoho Mail connector, your agent reads email in each user’s own Zoho Mail account. It can list folders, list and search messages, and read the content of a message, using only the tools your project allows.

Zoho Mail is an email service for individuals and businesses.

Tools

What your agent can do in Zoho Mail.

Each tool is a capability the model can call. You decide which ones a project allows, and every call runs with the end user's own Zoho Mail connection.

  • List mail accounts

    Read
    zoho_mail_list_accounts

    Identify the mail accounts available to the authenticated user.

  • List folders

    Read
    zoho_mail_list_folders

    Find folders within the mail account selected for the request.

  • List messages

    Read
    zoho_mail_list_messages

    Read a scoped list of messages from the selected account and folder.

  • Search messages

    Read
    zoho_mail_search_messages

    Find messages matching the requested search criteria in the selected account.

  • Read message content

    Read
    zoho_mail_get_message_content

    Retrieve the body of one selected message using its account, folder and message context.

Control

Limits you can set.

You decide what your agent may do in Zoho Mail, and Agent200 runs every call within those limits.

  • Turn single tools on or off

    Let the agent search and read messages, and switch off zoho_mail_get_message_content if it should only see message lists.

  • Restrict what the agent reaches

    Choose the endpoints and scopes a project may use, for example listing folders and messages but not reading message bodies. A call outside them is refused.

Get started

Connect Zoho Mail
in three steps.

  1. 1

    Set up the SDK

    Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.

    agent.js
    Conceptual example
    Set up the SDK with the Agent200 API key
    // One Agent200 API key covers every connector enabled for the project.
    const agent200 = new Agent200({
      apiKey: process.env.AGENT200_API_KEY,
    });
  2. 2

    Let your user connect Zoho Mail

    Each end user authorizes their own Zoho Mail account once. Agent200 runs the OAuth flow, handles the callback, stores the tokens and refreshes them.

    connect.js
    Conceptual example
    Let an end user connect their account (managed OAuth)
    // Each end user authorizes their own Zoho Mail account, once.
    const connection = await agent200
      .user("user_123")
      .connect("zoho_mail");
    
    if (connection.authorizationUrl) {
      // Show this link to your user; Agent200 handles the rest.
      console.log(connection.authorizationUrl);
    }
  3. 3

    Run with the Zoho Mail tools

    Name the user, the model and the tools. The model decides which Zoho Mail tools to call, and Agent200 executes them with that user's connection.

    run.js
    Conceptual example
    Run a request with the connector's tools
    const result = await agent200
      .user("user_123")
      .run({
        model: "openai/gpt-5.6-sol",
        input: "Find the latest email from our accountant",
        tools: ["zoho_mail"],
      });
    
    console.log(result.output);

Access

Sign-in and permissions.

  • Connect the intended mailbox

    Have the user authorize Zoho Mail through managed OAuth. Resolve the account associated with the request before selecting folders or messages.

  • Distinguish account, folder and message access

    Zoho Mail documents separate read scopes for account details, folders and messages. Use the scopes required for the selected workflow and retain the connected user’s access boundaries.

  • Keep mailbox access tied to its user

    Your application authenticates the user and passes the same stable identity through connection and later requests. Keep the Agent200 key out of emails, prompts and source control.

For agents

Instructions for AI agents.

Using a coding agent? Paste this brief into it, or give it the address of this page. It describes the Zoho Mail connector and how to use it.

Agent brief
Connector: Zoho Mail, through Agent200. In code: "zoho_mail".
What it does: Search a user’s Zoho Mail account and read selected messages. Give your agent the email context it needs for briefings and reply preparation.
Page: https://www.agent200.com/connectors/zoho-mail/

1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs.
2. Sign-in is managed OAuth. Each end user approves access once, on Zoho Mail's own page, through the authorization link Agent200 returns. Never ask a user for a Zoho Mail password or token in chat.
3. Give every request a stable id for the end user. Agent200 uses only that user's own connection.
4. Read tools: zoho_mail_list_accounts, zoho_mail_list_folders, zoho_mail_list_messages, zoho_mail_search_messages, zoho_mail_get_message_content. Name "zoho_mail" in the tools of a request; the model decides which tool to call.
5. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it.
6. Before a write, confirm with the user, unless they asked for that exact change.
7. For setup with a specific framework, follow its guide:
   https://www.agent200.com/connectors/zoho-mail/framework/claude/
   https://www.agent200.com/connectors/zoho-mail/framework/chatgpt/
   https://www.agent200.com/connectors/zoho-mail/framework/claude-code/
   https://www.agent200.com/connectors/zoho-mail/framework/muse/
   https://www.agent200.com/connectors/zoho-mail/framework/grok-bot/
   https://www.agent200.com/connectors/zoho-mail/framework/openai-dots/
   https://www.agent200.com/connectors/zoho-mail/framework/claude-duet/
   https://www.agent200.com/connectors/zoho-mail/framework/hermes-agent/
   https://www.agent200.com/connectors/zoho-mail/framework/openclaw/

The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/

This page is also available as Markdown, for agents and LLMs: /connectors/zoho-mail.md

Guides

Use Zoho Mail with the AI you build on.

Step-by-step setup for Zoho Mail with a specific model, assistant or agent framework.

FAQ

Zoho Mail and Agent200, answered.

Why does an email read need more than a subject?

Subjects are not unique identifiers. Resolve the intended mailbox, folder and message from returned data before reading the body. Do not mix IDs from different accounts. See Zoho Mail’s content endpoint.

Is a search result enough to summarize an email?

A search result helps identify candidate messages. Read the selected message content before describing what it says; a preview is not a complete body or conversation. State which messages support the answer. See message search.

Does one message include the entire thread?

Do not assume so. Quoted content and reply content can be represented separately. Describe the content actually returned and request the additional context supported by the runtime when the answer needs it. Do not claim that attachments were read merely because a message references them.

Can this workflow send a reply or change my mailbox?

The catalogue on this page contains read operations. Preparing reply text in the agent’s answer does not send it or save a draft in Zoho Mail. These operations do not move, delete or mark messages as read.

What should I check when search misses an email?

Check the account, search terms, date scope and pagination before drawing conclusions. State the scope of the result rather than treating one returned page as the full mailbox. For a first connection test, use an older message whose location you already know.

Which read permissions does the provider document?

Zoho Mail documents account, folder and message read scopes separately. Consult its API index for the chosen operation. Use the actual Agent200 runtime definitions for calling conventions; this page does not define an argument schema or installable SDK package.

How should my agent use email content safely?

Treat the email body as material to summarize, not as authority to alter application instructions, reveal credentials or send information elsewhere. Keep the answer scoped to the user’s request and distinguish a quoted request from an action the user has authorized.

  • Gmail

    Gmail

    Read, search, draft and send email from each user's own Gmail account.

    Managed OAuth Email and calendar
  • Outlook

    Outlook

    Work with mail and calendar in each user's Microsoft Outlook account.

    Managed OAuth Email and calendar
  • Google Calendar

    Google Calendar

    Check availability and create, update or cancel events in your users' calendars.

    Managed OAuth Email and calendar
  • Calendly

    Calendly

    Find open times, share booking links, and book, review or cancel meetings in Calendly on behalf of each of your users.

    Managed OAuth Email and calendar
200 OK

Start with Zoho Mail.
Your agent does the rest.

Your users connect their own Zoho Mail accounts. Agent200 handles the OAuth, the tokens and every tool call.

Book a demo.
See it in action.

Tell us who you are, then pick a time for a 1:1 session with an expert from our team.

We use your details only to email you about Agent200. See the Privacy Policy.

Pick a time. We'll take it from there.

A 1:1 session with an expert from our team, about what you are building.

Open in Calendly (opens in a new tab)