Connect Claude, ChatGPT or another assistant

imado hosts the email for your domain. You can connect an AI assistant, such as Claude, ChatGPT, Gemini or Cursor, to your imado account and ask it to read your mail, write drafts for you to send, tag your conversations, or set up a domain for you. You choose what it may do, and you can disconnect it at any time. Your assistant can't send mail through imado.

Start here

• To have it read a mailbox: add imado to your assistant (below), tick Read mail and the mailbox on the page imado opens, then ask it something like "Summarise this week's mail".
• To have it set up an address: add imado to your assistant, tick Manage your setup, then ask "Set up hello@yourdomain.com for me on imado". When the mailbox is ready, reconnect with Read mail if you want it to read that mailbox too (how).

Connect your assistant

Your assistant connects to imado through MCP, a common way for AI assistants to connect to other services. You give your assistant one link, the connector URL, and it opens imado in your browser for you to sign in. There is no password or key to paste into the assistant.

The connector URL is https://www.imado.cloud/api/mcp.

• Claude (web, desktop or phone): open Settings → Connectors, choose Add custom connector, name it imado and paste the connector URL. If you don't see Connectors, your Claude plan may not include custom connectors.

• ChatGPT: open chatgpt.com/plugins, choose +, then Add custom MCP server, name it imado and paste the connector URL.

• Gemini: open gemini.google.com/apps, choose Custom apps, then Add a custom app, and paste the connector URL. imado's page names it Google, the name Gemini gives itself. Google offers custom apps on the web, to personal Google Accounts in the US, in English. Once added, imado also works in the Gemini phone app; type @ in a chat to choose it.

• Cursor: open Settings → MCP → Add new MCP server, or add this to ~/.cursor/mcp.json:

  json

  {
    "mcpServers": {
      "imado": {
        "url": "https://www.imado.cloud/api/mcp"
      }
    }
  }
  

• Claude Code: run claude mcp add --transport http imado https://www.imado.cloud/api/mcp, then type /mcp and choose imado to sign in.

Most other assistants that support MCP connectors work the same way, with the same connector URL.

Choose what it may do

Once you add the connector, imado opens a page in your browser. Sign in to imado if you need to, check that the page names your assistant (for example, Claude), tick what it may do, and press Allow. Go back to your assistant and ask it something.

There are up to three things you can allow:

• Read mail: read the mailboxes you tick.
• Write drafts and add tags: write drafts in the mailboxes it reads, and put tags on their conversations or take them off. You or someone who reads the mailbox sends a draft; it can't send. You can tick it only with Read mail.
• Manage your setup: add domains and create mailboxes and addresses, and rename them. It can't remove anything, invite people or spend money.

A project is imado's name for a domain together with its mailboxes and the people who use them. You see Manage your setup if you manage a project (you do if you added its domain) or haven't added a domain yet. Someone who only reads mail in another person's project doesn't see it.

The page also shows whether imado could check where the app comes from. Identified by claude.ai means the app's details were published on claude.ai, so it is Claude. Unverified means the app described itself; allow it only if you are the one connecting it, right now. An app that returns to more than one address, such as the Gemini app, shows you this page every time it connects, so you always see where it goes.

Things to ask

• "Set up hello@yourdomain.com for me on imado."
• "Which DNS records do I still need to add for yourdomain.com?"
• "Summarise this week's mail in support@yourdomain.com."
• "Find the invoice from Acme in my imado inbox."

Reading mail

With Read mail, your assistant can list the mailboxes you ticked, list the conversations in one (by folder, by searching subjects and senders, or by tag), and read a conversation as text, with its tags. It sees the newest 20 messages of a conversation, up to 10,000 characters each.

It sees the message as imado shows it to you. It sees that a file is attached, with its name and size, but can't open it. It can't send mail, move or delete anything, and reading in your assistant doesn't mark anything as read. Writing drafts and adding tags needs Write drafts and add tags as well.

Writing drafts

With Write drafts and add tags, ask your assistant to reply to a conversation or to write a new message, and it saves a draft in the mailbox's Drafts. Nothing is sent: you open the draft, read it, change it if you like, and press Send.

• Everyone who reads the mailbox sees the draft, marked Drafted by Claude (or whichever app wrote it).
• A draft is plain text, with no attachments and no Bcc, sent from the mailbox's usual address.
• Your assistant can't change a draft once it has written it; it writes a new one instead. Once a person edits a draft, it's theirs.
• It doesn't reply to a conversation someone is already replying to, and it doesn't reply to mail in Spam.

Adding tags

With Write drafts and add tags, ask your assistant to tag a conversation, for example "Tag every invoice from Acme as Billing". It uses the mailbox's own tags, the ones you see in imado, and creates a tag when the name is new.

• Everyone who reads the mailbox sees the tags, and who added each one, named as your assistant.
• It can put tags on a conversation and take them off. It can't rename or delete a tag; anyone who reads the mailbox can, in Mail → Settings → Tags.
• A tag never does anything by itself: it doesn't move, forward or answer mail.

An assistant you connected before tags existed keeps writing drafts. To let it tag, disconnect it in Account → Connected apps and connect it again.

Setting up a domain

With Manage your setup, ask your assistant to set up an address, and it works through the same steps you would in imado:

1. It adds your domain. If you don't have a project yet, this creates one.
2. It gives you the DNS records to add. You add them at your domain's DNS host, the company where you manage the domain, usually where you bought it. The guides show where records go at each host.
3. It checks the records. imado also checks every domain once a day, so you can stop at any point and come back.
4. It creates your mailbox, and you read it in imado.

A few things stay with you. When your assistant reaches one, it gives you a link to do it in imado:

• A domain whose mail already arrives somewhere else, such as Google Workspace. Moving that mail is your decision, so you add the domain yourself.
• A few special addresses, such as admin@, postmaster@ and abuse@, which can receive mail that proves you own the domain.
• Removing anything, inviting people, and buying more domains.

Every change your assistant makes is listed in Account → Changes apps made: what it did, when, and anything imado refused. To undo a change, make it in Setup, the part of imado where you manage domains and mailboxes. Domains your assistant adds count towards your account's domain limit, the same as yours.

Set up a domain, then read its mail

Your assistant can't read a mailbox it creates until you let it. The safest order is:

1. Connect your assistant and allow only Manage your setup. Ask it to set up your address.
2. When the mailbox is ready, go to Account → Connected apps in imado and press Disconnect.
3. Connect again from your assistant. This time allow only Read mail, and tick the new mailbox.

To change what your assistant may do at any time, disconnect it in Account → Connected apps and connect again.

Shared mailboxes

If other people read a mailbox, they can see which apps can read it, in Mail → Settings → This mailbox → Apps that can read it. Each person's assistant reads only what that person can read, and loses access when they do.

Disconnect

Go to Account → Connected apps and press Disconnect. Your assistant loses access straight away. Changes it made stay, drafts it wrote stay in Drafts, and tags it added stay.

A connection you don't use for a month ends on its own. Resetting your imado password ends every connection, so a password you change after a leak also cuts off any assistant.

If you used an imado API key

Assistants now connect as described above, so imado no longer creates API keys. A key you already have keeps working until it expires or you revoke it in Setup → Plan → API keys.

For developers

You can skip this section. imado's server speaks MCP over Streamable HTTP and uses the standard MCP authorization flow, so a client registers itself and nobody copies a key. Requests are limited per person across all their apps; past the limit, the server answers 429 with Retry-After.

list_mailboxes · Read mail

The mailboxes you ticked: address, name, unread count

list_threads · Read mail

Conversations in one mailbox, 20 at a time, with their tags; one folder, a search, or one tag

read_thread · Read mail

One conversation as text

create_draft · Write drafts and add tags

Write a reply or a new message as a draft; it can't send

list_my_drafts · Write drafts and add tags

The drafts this app wrote that are still waiting

list_tags · Write drafts and add tags

One mailbox's tags, by name

tag_thread · Write drafts and add tags

Put tags on a conversation or take them off; a new name becomes a tag

list_projects · Manage your setup

Your projects and their domains

get_project · Manage your setup

One project's domains and mailboxes

get_domain · Manage your setup

A domain's DNS records and where it stands

add_domain · Manage your setup

Add a domain, or start a project with it

check_domain · Manage your setup

Check a domain's records now

create_mailbox · Manage your setup

Create a mailbox with its addresses

rename_project · Manage your setup

Rename a project

add_address · Manage your setup

Add an address to a mailbox (not when Read mail is also allowed)

set_primary_address · Manage your setup

Choose a mailbox's sending address (not when Read mail is also allowed)

rename_mailbox · Manage your setup

Rename a mailbox (not when Read mail is also allowed)

Eight tools only read: list_mailboxes, list_threads, read_thread, list_my_drafts, list_tags, list_projects, get_project and get_domain. Nine change something in imado: create_draft and tag_thread in a mailbox, and add_domain, check_domain, create_mailbox, rename_project, add_address, set_primary_address and rename_mailbox in your setup. add_domain and check_domain also look up the domain's records on the internet. tag_thread can take a tag off a conversation, and the tag stays in the mailbox. No tool sends mail, spends money or deletes anything. An app that reads mail gets every tool here except add_address, set_primary_address and rename_mailbox.