English Français العربية

OpenMail

Registre officiel Productivité

Gmail for agents: create inboxes, read and reply to mail, send email, manage domains. OAuth sign-in.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http openmail 'https://mcp.openmail.sh/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "openmail": {
            "type": "http",
            "url": "https://mcp.openmail.sh/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. OpenMail MCP
  2. Connect
  3. Env
  4. Local
  5. Contributing

OpenMail MCP

Hosted Streamable HTTP MCP at https://mcp.openmail.sh/mcp. Email inbox for AI agents: one inbox, read mail that wants a reply, reply in-thread.

There is no local stdio catalog — stdio-only clients should use mcp-remote.

Connect

Claude (OAuth): paste https://mcp.openmail.sh/mcp

Cursor (OAuth): Add to Cursor, or add the URL below without headers. Also on cursor.directory as a plugin (.cursor-plugin/plugin.json + mcp.json).

Claude Code: claude mcp add --transport http openmail https://mcp.openmail.sh/mcp, or install as a plugin (claude plugin marketplace add openmailsh/mcp, then claude plugin install openmail@openmailsh-mcp): the plugin bundles the server with the openmail skill in skills/, which teaches the agent when to reach for email and how to handle a thread.

VS Code / any registry client: listed in the MCP Registry as sh.openmail/openmail.

Cursor or headless agents (API key):

{
  "mcpServers": {
    "openmail": {
      "url": "https://mcp.openmail.sh/mcp",
      "headers": { "Authorization": "Bearer om_YOUR_KEY" }
    }
  }
}

Prefer an inbox-scoped key. Read-only: /mcp/readonly. One inbox: /mcp/inbox/{id}.

Keys and transcripts: over OAuth (Claude, Cursor sign-in) setup_agent_email and mint_inbox_key never return a token — the session is already authenticated, and anything returned lands in the chat. They point to the console, which shows a new key once in the browser. Over an API key (headless agent) the token is returned in the tool result; move it to the agent's env.

stdio-only clients: npx -y mcp-remote https://mcp.openmail.sh/mcp

Env

NamePurpose
OPENMAIL_API_URLAPI origin (https://api.openmail.sh)
MCP_RESOURCE_URLOAuth resource (https://mcp.openmail.sh)
MCP_JWT_SECRETSame secret as the API. Required in production; outside production falls back to NEXTAUTH_SECRET
CONSOLE_ORIGINConsent page host
PORTListen port
POSTHOG_API_KEYTurns on PostHog MCP Analytics ($mcp_tool_call per call). Unset = off
MCP_ANALYTICS_DEBUGSet to log every captured analytics event

See .env.example.

Local

pnpm install
pnpm test
pnpm dev

Contributing

Open an issue or PR. Run pnpm typecheck && pnpm test before pushing.

MIT © OpenMail

Questions fréquentes

Qu'est-ce que OpenMail ?

Gmail for agents: create inboxes, read and reply to mail, send email, manage domains. OAuth sign-in.

Comment installer OpenMail ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http openmail 'https://mcp.openmail.sh/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour OpenMail ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

OpenMail est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient OpenMail ?

Il est publié par openmailsh. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.