mailgenius-mcp

Stdio launcher for the MailGenius MCP server.

The hosted MCP server lives at https://mcp.mailgenius.pro/v1 and speaks the Streamable HTTP transport. This package is a tiny stdio bridge for editors (Claude Desktop, older Cursor builds, etc.) that only speak the stdio MCP transport.

Install for Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "mailgenius": {
      "command": "npx",
      "args": ["-y", "mailgenius-mcp@latest"],
      "env": { "MAILGENIUS_API_KEY": "mg_live_..." }
    }
  }
}

Install for Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mailgenius": {
      "command": "npx",
      "args": ["-y", "mailgenius-mcp@latest"],
      "env": { "MAILGENIUS_API_KEY": "mg_live_..." }
    }
  }
}

Generating an API key

In the MailGenius app, go to Settings → API keys, create a key with the scopes you want the agent to have, and copy the secret. The key is shown only once.

Connecting directly via HTTP

If your editor supports the Streamable HTTP MCP transport (recent Cursor builds, Claude Code, Continue, etc.), skip this package and point the editor at https://mcp.mailgenius.pro/v1 directly:

claude mcp add --transport http mailgenius https://mcp.mailgenius.pro/v1 \
  --header "Authorization: Bearer mg_live_..."

Configuration reference

Source	Field	Notes
MAILGENIUS_API_KEY env var	API key	Recommended for editors
MAILGENIUS_MCP_URL env var	URL	Override the MCP endpoint
--api-key=... flag	API key	Local debugging
--url=... flag	URL	Local debugging
~/.mailgenius/credentials.json apiKey	API key	Shared with the genius CLI
~/.mailgenius/credentials.json mcpUrl	URL	Shared with the genius CLI

License

MIT