Connecting AI Tools

Claude Desktop supports MCP servers via its configuration file.

1. Open the Claude Desktop configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the Mailcatcher server to the mcpServers object:

   {
     "mcpServers": {
       "mailcatcher": {
         "url": "https://app.mailcatcher.dev/_mcp",
         "headers": {
           "Authorization": "Bearer YOUR_MCP_TOKEN"
         }
       }
     }
   }
   

3. Replace YOUR_MCP_TOKEN with the token you generated from your profile page.
4. Restart Claude Desktop.

Once connected, you can ask Claude questions like:

"List the projects in my Mailcatcher account.""Show me the HTML of the latest email in my staging project."

Cursor supports MCP servers via its settings panel.

1. Open Cursor Settings → Tools & Integrations → MCP Servers
2. Click Add MCP Server and fill in:

   Field	Value
   Name	mailcatcher
   Type	http
   URL	https://app.mailcatcher.dev/_mcp

3. Under Headers, add:

   Key	Value
   Authorization	Bearer YOUR_MCP_TOKEN

4. Click Save.

The Mailcatcher tools will now appear in the Cursor Agent tool list. You can invoke them directly in the chat or let the agent use them automatically when you ask email-related questions.

Windsurf (by Codeium) supports MCP via its ~/.codeium/windsurf/mcp_config.json file.

1. Open or create ~/.codeium/windsurf/mcp_config.json
2. Add the Mailcatcher server:

   {
     "mcpServers": {
       "mailcatcher": {
         "serverUrl": "https://app.mailcatcher.dev/_mcp",
         "headers": {
           "Authorization": "Bearer YOUR_MCP_TOKEN"
         }
       }
     }
   }
   

3. Replace YOUR_MCP_TOKEN with your token and restart Windsurf.

Any MCP-compatible client that supports HTTP (SSE) transport can connect to Mailcatcher.

Server URL:

https://app.mailcatcher.dev/_mcp

Authentication header:

Authorization: Bearer YOUR_MCP_TOKEN

For clients that use a JSON configuration file (following the MCP spec), the typical entry looks like:

{
  "mcpServers": {
    "mailcatcher": {
      "url": "https://app.mailcatcher.dev/_mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Refer to your client's documentation for the exact configuration format.