Skip to main content
Glama

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).

Related MCP server: Constant Contact MCP Server

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.

License

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides comprehensive access to the Constant Contact API v3 for email marketing, campaign management, contact management, analytics, and automation through MCP tools.
    2
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables agents to create and manage durable email workflows, templates, contacts, and enrollments over MCP.
    8 npm
    2
    AGPL 3.0