Opus MailSign in

Docs · Claude

Opus Mail, with Claude.

Let Claude read, search and organize your mail and write drafts for you. You approve each connection in your browser and never copy a token. Claude drafts, and you send.

Terminal

Claude Code

Add Opus Mail as a remote MCP server:

claude mcp add --transport http opusmail https://www.opusmail.org/mcp

Add --scope user to make it available in every project, not just this one.

Then, in Claude Code, run /mcp, pick opusmail and choose Authenticate. Your browser opens on opusmail.org. Sign in if asked and click Approve. Claude Code keeps itself signed in from then on.

Desktop, web and mobile

Claude Desktop and claude.ai

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Opus Mail and use this URL:
    https://www.opusmail.org/mcp
  3. Click Connect, then Approve on opusmail.org.

A connector you add on claude.ai also shows up in Claude Desktop and the mobile apps. Whether you can add custom connectors depends on your Claude plan.

Browser extension

Claude in Chrome

Nothing to set up and no token to paste. Claude works in your own signed-in browser tab.

  1. Sign in at https://www.opusmail.org/mail in Chrome.
  2. Open Claude in the side panel.
  3. Ask it to read, search or draft a reply, for example “Summarize my unread mail” or “Find the invoice from Maya and start a reply”.

Claude can type a reply into the page, but sending is always your click.

What Claude can and can't do

When you approve a connection, you grant these permissions:

PermissionAllows
mail.readList, read and search your mail
mail.draftWrite drafts and reply drafts, mark read, star and move messages
mail.sendNever granted. Sending is always your click in Opus Mail.

Drafts Claude writes land in Drafts, marked with the app that wrote them. Open one, edit it if you like, and click Send, or delete it. Nothing goes out until you do.

Revoke access

Open Connected apps to see every app you approved, its permissions and when it was last used. Click Revoke and the app’s next request fails. It has to ask you again to reconnect.

Privacy and security

  • Anyone can email you, so message text is untrusted. Opus Mail marks it that way for Claude and tells Claude never to follow instructions found inside an email. That’s also why no tool can send mail.
  • Connections use OAuth with PKCE. Access lasts an hour and renews itself. Opus Mail stores only hashes of the credentials, never the credentials themselves.
  • Every tool Claude runs on your mail is logged against your account and rate limited.
  • Claude in Chrome uses your own signed-in browser session, so no credential exists to leak at all.

Troubleshooting

The browser says I'm not signed in
Approving a connection needs an Opus Mail account. Sign in when asked, and you'll come back to the approval page.
Claude gets 401 errors after I revoked it
That's the revoke working. To reconnect, run /mcp in Claude Code and choose Authenticate again, or reconnect the connector in Claude's settings.
The connector shows no tools
Check that the URL ends in /mcp and that you clicked Approve. Then disconnect and connect again. If it still lists nothing, revoke the app on Connected apps and start over.
Claude in Chrome can't see my mail
Open opusmail.org/mail in the same Chrome profile and make sure you're signed in. Claude only sees the tabs you let it use.