Avatar
Mailbird Support

Mailbird Next includes a local Model Context Protocol (MCP) server. ChatGPT cannot connect directly to a local https://127.0.0.1 MCP server the same way Claude Desktop can, so ChatGPT users need OpenAI's Secure MCP Tunnel flow.

For a full overview of Mailbird's MCP server, available tools, privacy model, and write-action permissions, see Connect Claude, ChatGPT, and OpenClaw to Mailbird Next (MCP Server Setup).

Who this setup is for

  • You use ChatGPT with custom MCP connectors or Developer Mode.
  • You are comfortable installing and running OpenAI's tunnel client.
  • You want ChatGPT to reach Mailbird running on your own computer without exposing Mailbird's local MCP server directly to the internet.

If you only need a simple local desktop setup, Claude Desktop is currently easier because it can launch a local MCP bridge from its desktop configuration file.

What you need

  • Mailbird Next with the MCP server enabled.
  • The HTTPS endpoint shown in Mailbird, for example https://127.0.0.1:52000/mcp.
  • The MCP bearer token from Mailbird's Wingman AI settings.
  • An OpenAI account and ChatGPT workspace that supports custom MCP connectors / Developer Mode.
  • OpenAI Secure MCP Tunnel access and the tunnel-client installed on the same computer as Mailbird, or on a machine that can reach Mailbird's local endpoint.

1. Enable MCP in Mailbird

  1. Open Mailbird Next.
  2. Go to Settings → Wingman AI.
  3. Turn on Enable MCP server.
  4. Copy the endpoint shown in the status row. It should look like https://127.0.0.1:52000/mcp, though the port may be different.
  5. Copy the authentication token.

2. Create a Secure MCP Tunnel in OpenAI

Follow OpenAI's Secure MCP Tunnel documentation to create a tunnel for a private MCP server. OpenAI's tunnel is designed for private or on-prem MCP servers and uses an outbound-only tunnel client rather than requiring you to publish the local server publicly.

OpenAI documentation:

3. Point the tunnel client at Mailbird

When configuring the tunnel target, use the Mailbird MCP endpoint as the upstream MCP server:

https://127.0.0.1:52000/mcp

If Mailbird shows a different port, use that port instead.

Configure the tunnel or connector to send Mailbird's bearer token with every request:

Authorization: Bearer YOUR-MAILBIRD-MCP-TOKEN

Replace YOUR-MAILBIRD-MCP-TOKEN with the token copied from Mailbird. Keep the Authorization: Bearer prefix.

4. Add the connector in ChatGPT

  1. Open ChatGPT.
  2. Open the Developer Mode or custom connector flow for MCP.
  3. Add a new MCP connector using the public tunnel URL created by OpenAI Secure MCP Tunnel.
  4. Complete any ChatGPT connector prompts and save the connector.
  5. Ask ChatGPT a simple read-only question, such as "Check my Mailbird inbox and tell me what's new."

Important limitations

  • ChatGPT does not currently use Claude Desktop's claude_desktop_config.json local command setup.
  • Do not point ChatGPT directly at https://127.0.0.1:52000/mcp. That address only exists on your own computer.
  • Secure MCP Tunnel is an advanced/developer setup. If your ChatGPT plan or workspace does not expose custom MCP connectors or Developer Mode, you will not be able to complete this setup yourself.
  • Mailbird's local MCP certificate is self-signed. If your tunnel client validates local TLS strictly, you may need to trust Mailbird's local certificate or configure the tunnel client to accept the local certificate according to OpenAI's tunnel-client instructions.

Troubleshooting

  • ChatGPT cannot reach Mailbird - Make sure Mailbird is open and the MCP server status says it is running.
  • Unauthorized or 401 - Copy the token from Mailbird again and update the bearer token used by the tunnel or connector.
  • Connection refused - Check that the tunnel client is running on the same machine as Mailbird, and that the endpoint URL and port match Mailbird's status row.
  • Certificate error - The local Mailbird MCP server uses a self-signed HTTPS certificate. Trust the local certificate or adjust the tunnel-client configuration according to OpenAI's guidance.
  • Write actions do not work - In Mailbird, turn on Allow write actions in the Wingman AI settings. Sending still requires explicit confirmation.

Privacy and permissions

  • Mailbird's MCP server is off by default and only starts when you enable it.
  • The local server binds to loopback only, so other devices on your network cannot reach it directly.
  • The tunnel client makes the outbound connection to OpenAI's tunnel service. Treat the Mailbird bearer token like a password.
  • Read-only MCP tools work when the server is running. Write and destructive tools require Allow write actions in Mailbird.

Related articles

Articles in this section

See more