Skip to main content
The Paubox MCP Server authenticates against the Paubox Email API on your behalf. You provide your API key once when configuring the server; it is never sent to the AI model.
1

Sign up for a Paubox account

If you don’t have one, sign up for Paubox Email API. Free tier includes up to 300 emails per month.
2

Add and verify your domain

Go to Paubox Email API > Settings and add the domain you will send from. Complete domain verification before generating an API key; unverified domains cannot send email.
3

Generate an API key

From Paubox Email API > Settings, click your domain, then press Add API Key. Give the key a description and save it immediately; it is displayed only once.
4

Pass your API key to the MCP server

The server resolves the API key using the following priority order. Use whichever method fits your client:1. OAuth connector form (recommended for Claude.ai and Claude Desktop)Add https://mcp.paubox.com as a connector. The client presents a Configure Paubox form automatically. Enter your API key once; the client stores a short-lived encrypted Bearer token and sends it on every subsequent request.2. Custom request headersSome MCP clients let you set custom headers on the connector. Pass:
3. Environment variables (stdio / Claude Code)
Claude Code / stdio config:
4. Per-call tool parameters (any transport)Pass apiKey directly in each tool call. This takes the highest runtime priority and overrides any other credential source. Useful for scripted clients or one-off requests.
Never commit API keys to source control. Use environment variables or a secrets manager to inject credentials at runtime.

​
Required permissions

A single API key generated from the Paubox Email API settings page covers all authenticated tools. The get_form and submit_form tools call public Forms API endpoints and require no credentials.