Skip to content
MCP server

Mailgi

Real inboxes for AI agents over MCP: register, send, receive and file mail, 67 tools

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Mailgi

Mailgi is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

The agent can get its own working address with no human step. Connect with no headers, call register_agent, and the server returns an email address plus an API key beginning amb_, shown once; you then re-add the server with that key as a bearer header. A separate path gives organisation tools: org_login_request_code emails a human a six-digit code, org_login_verify returns a session token, and regtoken_create lets an admin agent hand a registration token to another agent for a company domain.

The MCP server runs inside the Mailgi API and each of its 67 tools forwards to a REST endpoint with the same validation, rate limits and metering, so a tool call and the equivalent curl behave the same. It is stateless, takes credentials as headers rather than tool arguments, and serves one resource, mailgi://skill. There is no OAuth.

Receiving is free and mail sent to the outside world is pay-as-you-go. A TypeScript SDK and CLI are in the repository under MIT. Claude Desktop needs the mcp-remote bridge, while Cursor connects over HTTP directly.

Install

Run in a terminal

claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp

Add to Settings → Connectors → Add custom connector

https://api.mailgi.xyz/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailgi": {
      "url": "https://api.mailgi.xyz/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mailgi": {
      "type": "http",
      "url": "https://api.mailgi.xyz/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailgi": {
      "serverUrl": "https://api.mailgi.xyz/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mailgi": {
      "type": "http",
      "url": "https://api.mailgi.xyz/mcp"
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

register_agent
Create an agent address and API key.
org_login_request_code
Email an organisation admin a login code.
org_login_verify
Verify the code and return a dashboard session token.
org_logout
End the organisation session.
regtoken_create
Create a registration token for another agent on the company domain.

What it does

Self-registration
register_agent returns an address and key with no human.
1:1 REST proxy
Each tool maps to an API endpoint with identical limits and billing.
Header-based auth
Agent key and organisation session travel as headers.
Organisation tools
Domains, members, registration tokens and a wallet.
Skill resource
mailgi://skill serves a plain-language API guide.
SDK and CLI
TypeScript SDK and a mailgi command.

Good for

  • Give an agent an inbox to receive verification codes
  • Run a support mailbox for an agent
  • Let an admin agent onboard other agents onto a company domain
  • Send transactional mail from an agent
  • File and read incoming mail

Pricing

Freemium

Receiving free; outbound mail pay-as-you-go

Prices change. Check mailgi.xyz before you buy.

Mailgi FAQ

Does it use OAuth?

No. The agent obtains a key through a tool, and a human adds it to the client config once.

What does it cost?

Receiving is free; mail to the outside world is pay-as-you-go.

Is state kept between calls?

No, the server is stateless.

How do I connect Claude Desktop?

Through the mcp-remote bridge, which needs Node.js.

Is Mailgi free?

Mailgi has a free plan, with paid plans for more usage or features.

How do I add Mailgi to Claude Code?

Run this command in your terminal: claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp

What are the best alternatives to Mailgi?

The closest alternatives to Mailgi are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Mailgi

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity