Use mail by samayo with AI agents

Last updated: 24 October 2026

mail by samayo has a remote MCP server. It lets an AI agent, such as Claude or ChatGPT, read, organize, and write the email in all the accounts of your workspace: Gmail, Outlook, Microsoft 365, and hosted addresses.

Before you start

You need a mail by samayo workspace. Open mail.samayo.me and connect at least one email account.

Connect Claude

• Open Settings › Connectors in Claude. Find mail by samayo in the directory, or click Add custom connector and enter https://mail.samayo.me/mcp.
• Click Connect. A browser window opens.
• Sign in to mail by samayo, if the browser is not signed in. Then read the consent page, and click Allow.

Connect ChatGPT

• Open the apps of ChatGPT, and find mail by samayo.
• Click Connect, sign in to mail by samayo, and click Allow on the consent page.

Connect another MCP client

Add https://mail.samayo.me/mcp as a remote MCP server (Streamable HTTP). The client signs in with OAuth 2.1. The server supports Client ID Metadata Documents and Dynamic Client Registration.

Permissions

• Read: read and search your email in all accounts.
• Organize: archive, delete, star, and mark your email as read.
• Send: send email from your accounts.

The consent page shows the permissions and the accounts before you allow the agent. The agent gets only the data of the tools that it calls.

Tools

• list_accounts (Read): Lists the accounts of the workspace, with the unread count of each inbox.
• search_threads (Read): Lists or searches the conversations of a folder, in one account or in all accounts.
• get_thread (Read): Reads all messages of a conversation as text, with the list of attachments.
• get_attachment (Read): Gets one attachment of a message, up to 10 MB.
• compose_message (Read): Writes an email and shows it in the chat, where you edit it and press Send. It sends nothing itself.
• modify_threads (Organize): Archives, deletes, stars, or marks conversations as read or spam.
• send_message (Send): Sends a new email, a reply, a reply to all, or a forward.

Write an email in the chat

When you ask the agent to write an email, it calls compose_message. The chat shows the email: the sender, the recipients, the subject, and the body. Edit any field, and press Send. For a new email, you can choose the account that sends it. A reply always comes from the account of its conversation. Clients that cannot show the view get the draft as text, and the agent asks you before it sends.

Examples

• "Summarize the unread mail in my inboxes from today."
• "Find the email from Maya about the Q4 roadmap, and write a reply that says Thursday works."
• "Archive the newsletters in my work inbox from last week."
• "Write an email from my Gmail to Sam that asks for the brand colours."

Safety

Email comes from other people, and a message can contain instructions for an agent. Allow only agents that you trust, and keep the agent's approval settings on for actions that send or delete mail. Claude and ChatGPT ask you before they send or delete mail.

Disconnect an agent

Open Settings › AI agents in mail by samayo, and click Disconnect. The agent loses access at once. You can also remove the connector in Claude or ChatGPT.

Privacy

The privacy policy tells which data the agent gets and which data mail by samayo keeps.

Support

If you have a question or a problem, send an email to mail@samayo.me.