Picking a transport: the hosted HTTP connector (
https://mcp.paubox.com) needs nothing installed. The stdio option runs the @paubox/mcp npm package on your own machine and requires Node.js ≥ 22 — a higher floor than the Paubox CLI, which supports Node.js ≥ 20.12.0, so a machine that runs the CLI will not necessarily run the stdio server. npm only warns on a version mismatch rather than refusing, so check node --version before assuming a failed stdio launch is a credential problem.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
- In Claude.ai, open Settings > Connectors.
- Click Add connector and enter the server URL:
- A Configure Paubox form opens automatically. Enter your API key.
- Click Save. Claude stores your API key as a secure token and sends it on every request.
3
Connect via Claude Desktop
Open (or create) The config file is located at:
claude_desktop_config.json and add the paubox entry to mcpServers:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
4
Connect via Claude Code
Run this command once with your API key (no credential prompts afterward):Claude Code spawns the package locally and injects the API key as an environment variable.
5
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 sourceTrackingId you can use to check delivery status.Other MCP-compatible clients
Any client that supports the MCP specification can connect using either transport:- HTTP:
https://mcp.paubox.com; setx-paubox-api-keyas a custom request header. The OAuth credential form works for clients that receive the OAuth callback onlocalhost. - stdio: run
npx @paubox/mcp@latestwithPAUBOX_API_KEYset in the environment