Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paubox.com/llms.txt

Use this file to discover all available pages before exploring further.

1

Get your API key

Before connecting, you need a Paubox Email API key. See Authentication for how to generate one from the Paubox dashboard.
2

Connect via Claude.ai

  1. In Claude.ai, open Settings > Integrations.
  2. Click Add integration and choose MCP server.
  3. Enter the server URL:
https://mcp.paubox.com/sse
  1. When prompted, provide your API key as the PAUBOX_API_KEY credential.
  2. Click Save. Claude will discover the available Paubox tools automatically.
3

Connect via Claude Desktop

Open (or create) claude_desktop_config.json and add the paubox entry to mcpServers:
{
  "mcpServers": {
    "paubox": {
      "command": "npx",
      "args": ["-y", "@paubox/mcp-server"],
      "env": {
        "PAUBOX_API_KEY": "YOUR_API_KEY",
        "PAUBOX_API_USERNAME": "YOUR_API_USERNAME"
      }
    }
  }
}
The config file is located at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after saving.
4

Test the connection

Ask Claude to verify your credentials:
“Use the Paubox MCP server to validate my credentials.”
Claude will call validate_credentials and confirm your API key is working. Then try sending a test email:
“Send a test email to me@example.com from sender@yourdomain.com with the subject ‘Hello from MCP’.”
Claude will call send_secure_email and return a source_tracking_id you can use to check delivery status.

​
Other MCP-compatible clients

Any client that supports the MCP specification can connect using either transport:
  • SSE (HTTP): https://mcp.paubox.com/sse with Authorization: Token token=YOUR_API_KEY
  • stdio: run npx -y @paubox/mcp-server with PAUBOX_API_KEY and PAUBOX_API_USERNAME set in the environment