MCP
Server
The official Model Context Protocol server for Posthawk. Let AI agents like Claude, Cursor, and Windsurf send emails, manage contacts, and check domain status through natural language.
$ npx posthawk-mcpOne config,
instant access
Claude Code connects via OAuth — just run one command and authorize in your browser. Cursor, VS Code, and Windsurf use a local config with your API key.
# Recommended: OAuth (no API key needed)claude mcp add --transport http posthawk https://mcp.posthawk.dev/mcp# Alternative: API key via stdioclaude mcp add posthawk -e POSTHAWK_API_KEY=ck_live_... -- npx posthawk-mcpYou: "Send a welcome email to alex@example.com from hello@posthawk.dev"Claude: I'll send that email now.[Calling send-email with: from: hello@posthawk.dev to: alex@example.com subject: Welcome! html: <h1>Welcome to Posthawk!</h1>]Done! Email queued with job ID job_abc123.:Status: processingJust ask your
AI to send it
No SDK imports, no HTTP calls. Describe what you want and the AI picks the right tool. Works with Claude Code, Cursor, and any MCP client.
16 tools across
6 domains
Emails
- send-email
- get-email
Scheduled
- list-scheduled
- get-scheduled
- cancel-scheduled
- reschedule-email
Contacts
- list-contacts
- get-contact
- create-contact
- update-contact
- delete-contact
Domains
- list-domains
- get-domain
- verify-domain
Templates
- render-template
Webhooks
- list-webhooks
- create-webhook
- delete-webhook
Up and running
in minutes
Connect the server
One command to connect. Claude Code uses OAuth — no API key needed. Other clients use npx with an API key.
Authorize in your browser
OAuth opens your browser, you pick a workspace and click Authorize. API key is created automatically.
Ask your AI
"Send a welcome email to user@example.com" — the AI picks the right tool and executes it.
16 Tools
Send emails, manage contacts, check domains, render templates, and configure webhooks — all through natural language.
OAuth 2.1
Full OAuth 2.1 support with PKCE and dynamic client registration for secure remote access.
Self-Hosted Ready
Set POSTHAWK_BASE_URL to connect to any self-hosted Posthawk instance. Same tools, your infrastructure.
Dual Transport
stdio for local development (Claude Code, Cursor) and Streamable HTTP for remote hosted access.
Let AI handle your email
Connect Posthawk to your AI workflow in under a minute.