Stdio launcher for the MailGenius MCP server.
Overview
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. ~/Library/Application Support/Claude/claude_desktop_config.json: In the MailGenius app, go to , create a key with the scopes you want the agent to have, and copy the secret. The key is shown only once. 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:
README
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
Install
npx -y mailgenius-mcp@latestConfiguration
{
"mcpServers": {
"mailgenius": {
"command": "npx",
"args": ["-y", "mailgenius-mcp@latest"],
"env": { "MAILGENIUS_API_KEY": "mg_live_..." }
}
}
}