MailSenpai

About this repository. It contains only documentation and client manifests (the official MCP Registry entry and configuration files for Claude, Cursor, Gemini CLI and other MCP clients). The server source code is not published here. The server runs at the URL below and is operated by MailSenpai.

What you need

• A MailSenpai account with AI access enabled. You can start with a free demo account at www.mailsenpai.com (English: en.mailsenpai.com).
• An MCP client that supports remote servers with OAuth.

On first use, the client opens the MailSenpai sign-in page. Sign in with your MailSenpai email and password, review the requested access, accept the terms and you are sent back to the client. Your password is never shared with the AI client.

What the tools can do

The server exposes 74 tools, each annotated as read-only, write or destructive.

Example prompts:

• "List my lists and how many confirmed subscribers they have."
• "Create a draft campaign for the Customers list using the Welcome template."
• "Summarize the statistics of my last five campaigns."
• "Check the SPF, DKIM and DMARC records of example.com and tell me what to fix."
• "Create a segment of subscribers who joined in the last 30 days."

Permissions and confirmations

• The access token only receives the permissions of your MailSenpai plan and role, even if the client asks for more.
• Deleting requires confirm_delete, sending requires confirm_send. Sending, scheduling and deleting are available only if your plan includes them.
• Calls are logged and rate-limited. Details: https://mcp.mailsenpai.com/rate-limits and https://mcp.mailsenpai.com/security

Connect it

Claude (claude.ai and Claude Desktop)

Settings → Connectors → Add custom connector. Name: MailSenpai, URL: https://mcp.mailsenpai.com/mcp. Select Connect and sign in with your MailSenpai account.

Claude Code

claude mcp add --transport http mailsenpai https://mcp.mailsenpai.com/mcp

Then run /mcp inside Claude Code and choose Authenticate for mailsenpai.

This repository is also a Claude Code plugin (.claude-plugin/plugin.json + .mcp.json).

ChatGPT

In ChatGPT settings, add a custom connector (app) with the URL https://mcp.mailsenpai.com/mcp and OAuth authentication, then sign in with your MailSenpai account. Depending on your ChatGPT plan, developer mode may be required.

Cursor

One click: Add MailSenpai to Cursor

Or add it to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "mailsenpai": {
      "url": "https://mcp.mailsenpai.com/mcp"
    }
  }
}

Cursor shows a Needs login button next to the server: click it to sign in.

Cline

Open the MCP Servers panel → Remote Servers, name mailsenpai, URL https://mcp.mailsenpai.com/mcp, transport Streamable HTTP. Or edit cline_mcp_settings.json:

{
  "mcpServers": {
    "mailsenpai": {
      "type": "streamableHttp",
      "url": "https://mcp.mailsenpai.com/mcp"
    }
  }
}

When Cline asks you to authenticate, sign in with your MailSenpai account.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "mailsenpai": {
      "type": "http",
      "url": "https://mcp.mailsenpai.com/mcp"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/mailsenpai/mailsenpai-mcp

Then run /mcp auth mailsenpai to sign in.

Other MCP clients

Add a remote MCP server with the URL https://mcp.mailsenpai.com/mcp. Clients that only support local (stdio) servers can use a bridge such as mcp-remote:

{
  "mcpServers": {
    "mailsenpai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.mailsenpai.com/mcp"]
    }
  }
}

Disconnect

Remove the connector from your AI client's settings. Issued access expires on its own; to revoke it right away, contact support from https://mcp.mailsenpai.com/support.

Files in this repository

Agent Plugins Directory

The hosted connector is indexed in the Agent Plugins Directory. The directory reads the public plugin.json and mcp.json manifests. It can discover the hosted server without access to its source code. Follow the OAuth setup above after installation.

Guides: English · Italian.

Related service

For transactional email, MailSenpai also offers SMTP Senpai, an SMTP relay and email API. See the API documentation and integration guides.

Also listed on

Official MCP Registry · Smithery · Glama

License

The files in this repository (README, manifests and configuration examples) are released under the MIT License. The license does not cover the MailSenpai service or the hosted MCP server, whose source code is not included here.