English Français العربية

Mailly

Registre officiel Sécurité

A real inbox for agents: read mail, draft replies you approve, wait for verification codes.

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 mailly 'https://mcp.mailly.site/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailly": {
            "type": "http",
            "url": "https://mcp.mailly.site/mcp"
        }
    }
}

Documentation

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

Sommaire
  1. mailly-mcp
  2. Use the hosted server
  3. Run it yourself
  4. Develop
  5. License

mailly-mcp

The MCP server behind Mailly's connector, plus the Mailly plugin for Claude and Codex.

  • src/: the MCP server, a Cloudflare Worker. It offers typed tools for Mailly mail, drafts, sending, domains, contacts, templates, campaigns, workflows and webhooks. Every tool calls the Mailly REST API with the caller's Mailly API key, so authentication, billing and workspace isolation all stay in the API.
  • ui/: the MCP Apps UI (email and draft cards), bundled into ui:// resources. It is off unless MCP_APPS=1.
  • plugins/mailly: the plugin for Claude (claude.ai, Cowork and Claude Code) and Codex. It points at the hosted server and adds a skill for working with email safely.

Use the hosted server

Add https://mcp.mailly.site/mcp as a remote MCP server and sign in with your Mailly account (OAuth). In Claude Code you can install the plugin instead:

/plugin install mailly --marketplace superagents-lab/mailly-mcp

This server is an OAuth protected resource. Mailly's API (https://api.mailly.site/api/auth) is the authorization server: clients find it through /.well-known/oauth-protected-resource, sign the user in there, and send the access token here. The server passes the token, or an API key, unchanged to Mailly's REST API, which checks it and the scopes it carries. The tool list is narrowed to the same scopes (GET /me).

Run it yourself

npm install
npm run dev          # wrangler dev on http://localhost:8787/mcp

Call /mcp with Authorization: Bearer <your Mailly API key> (from https://mailly.site/app/developers). Without the MAILLY_API service binding it calls MAILLY_API_URL (default https://api.mailly.site) over the internet. To host your own copy, change the mcp.mailly.site route in wrangler.jsonc. OAuth sign-in only works at https://mcp.mailly.site/mcp, because Mailly issues tokens for that resource; elsewhere use an API key.

Develop

npm run typecheck
npm test             # builds dist/worker.js and runs it in Miniflare against a stub API

The Mailly server repository runs its OAuth and end-to-end tests against dist/worker.js from a sibling checkout of this repository.

server.json is the listing in the MCP Registry as site.mailly/mcp. The site.mailly namespace is proven by a DNS TXT record on mailly.site, so publish with mcp-publisher login dns --domain mailly.site --private-key <key> and mcp-publisher publish from a machine that holds the key. Bump version for each release.

License

MIT

Questions fréquentes

Qu'est-ce que Mailly ?

A real inbox for agents: read mail, draft replies you approve, wait for verification codes.

Comment installer Mailly ?

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

Faut-il une clé API pour Mailly ?

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.

Mailly est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Mailly ?

Il est publié par superagents-lab. 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.