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
- Open Settings → Connectors and choose Add custom connector.
- Name it Opus Mail and use this URL:
https://www.opusmail.org/mcp
- 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.
- Sign in at https://www.opusmail.org/mail in Chrome.
- Open Claude in the side panel.
- 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:
| Permission | Allows |
|---|---|
| mail.read | List, read and search your mail |
| mail.draft | Write drafts and reply drafts, mark read, star and move messages |
| mail.send | Never 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.