MCP Setup

Mailgent provides a hosted MCP server at https://api.mailgent.dev/mcp. No packages to install — just a URL and your API key.

Claude Code

Add to your project's .claude/settings.json or ~/.claude.json:

{
  "mcpServers": {
    "mailgent": {
      "url": "https://api.mailgent.dev/mcp",
      "headers": {
        "Authorization": "Bearer mgent-your-api-key"
      }
    }
  }
}

Restart Claude Code. The mail.* tools will appear.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mailgent": {
      "url": "https://api.mailgent.dev/mcp",
      "headers": {
        "Authorization": "Bearer mgent-your-api-key"
      }
    }
  }
}

Any MCP Client

Mailgent uses the Streamable HTTP transport (MCP spec). Any client that supports URL-based MCP servers will work:

URL:    https://api.mailgent.dev/mcp
Method: POST (for tool calls), GET (for SSE)
Auth:   Authorization: Bearer mgent-your-api-key

Verify Connection

Once configured, ask your agent:

"What mail tools do you have?"

It should list the available mail.* tools based on your identity's scopes.

Next Steps