QMailing — Model Context Protocol
Two ways to plug an AI agent into QMailing — pick the one that matches your client.
| Client | Recommended setup |
|---|---|
| Claude.ai (web / mobile) | Custom Connector — one URL, no token, OAuth handles auth |
| Claude Desktop, Cursor, Continue, Zed, custom CLIs | @qmailing/mcp-server — npm package + API token |
The two paths give the same tool surface — qmailing_list_mailboxes,
qmailing_send_email, etc. They differ only in how the client
authenticates: OAuth flow (browser) vs static bearer token (CLI / config).
🔗 Claude.ai Custom Connector (recommended)
Works with the Claude.ai web app and Claude mobile. No package install, no token management — the OAuth flow brokers per-grant scope consent and rotates refresh tokens automatically.
Setup (60 seconds)
- Sign in at https://qmailing.com.
- Go to Settings → Developers — copy the Server URL at the top:
https://qmailing.com/mcp - Open Claude.ai → Settings → Connectors → Add custom connector.
- Paste the server URL into the form. Claude.ai redirects you back to QMailing to sign in.
- Approve the requested scopes (Read mailboxes / Send emails / etc.) — the consent screen lists each one with a description before you click Allow.
- Done. Claude.ai shows the QMailing tools in its tool tray on every chat.






