MAILROOM Back to dashboard

Operator guide

Open a secure route from ChatGPT to business email.

Mailroom keeps provider credentials on your server. ChatGPT receives a short-lived OAuth token and only sees the sender labels you connect.

01

Run locally

Install dependencies, generate secrets, and start the server:

npm install
npm run setup
npm run dev

Open http://localhost:3310 and use the admin password printed by the setup command.

02

Enable Gmail Workspace

  1. Create a project in Google Cloud and enable the Gmail API.
  2. Configure an OAuth consent screen.
  3. Under Data Access, add openid, email, gmail.send, and gmail.readonly. Google grants read-only access to all mailbox messages, bodies, and attachments; Mailroom uses it for reply tracking and cannot modify or delete mail.
  4. Create an OAuth client with application type Web application.
  5. Add http://localhost:3310/oauth/google/callback as an authorized redirect URI.
  6. Put the client ID and client secret in .env, then restart Mailroom.

For a deployed HTTPS domain, replace the localhost origin in both PUBLIC_BASE_URL and the Google redirect URI. gmail.readonly is restricted: external production use generally requires Google verification, and server-side handling of restricted Gmail data can require an annual security assessment.

03

Connect Neo or Hostinger

Choose the provider in the dashboard and enter the complete mailbox address and mailbox password. The official defaults are prefilled:

ProviderSMTPIMAP
Neo Businesssmtp0001.neo.space:587imap0001.neo.space:993
Hostinger Emailsmtp.hostinger.com:465imap.hostinger.com:993

Mailroom verifies SMTP before saving. Neo also requires a working IMAP Sent folder; Sent copying is optional for Hostinger. If a Sent copy later fails after SMTP delivery, Mailroom reports the delivery with a warning instead of claiming that it failed.

04

Connect ChatGPT

  1. Deploy the server at a stable HTTPS address, or use OpenAI Secure MCP Tunnel for private developer testing.
  2. Set PUBLIC_BASE_URL to that public origin and restart the server.
  3. In ChatGPT, open Settings → Security and login and enable Developer mode.
  4. Open ChatGPT Plugins, add a connection, and enter the dashboard’s MCP endpoint ending in /mcp.
  5. Authorize with the Mailroom admin password.

Then try: “List my sender accounts.” Follow with: “Send an email from Sales inbox to [email protected] with subject …”

Write-action safetyThe send tool is marked destructive, and every send uses an idempotency key so a retry returns the earlier result instead of delivering twice.