Set up AgentInbox with Windsurf

Give your Windsurf AI agent a real email address in under two minutes. Connect AgentInbox as an MCP server and start sending and receiving emails from Cascade.

Prerequisites

1. Windsurf IDE installed — latest version with MCP support.

Add via Windsurf Settings

The fastest way to get started — no config files needed.

Open Windsurf Settings
Navigate to the MCP section
Click Add Server
Fill in the fields:
Field Value
Name agentinbox
Type HTTP
URL https://mcp.agentinbox.sh/mcp
Click Save — the server appears in your MCP list

Or add via .windsurf/mcp.json

Prefer config-as-code? Create a .windsurf/mcp.json file in your project root:

.windsurf/mcp.json

{
  "mcpServers": {
    "agentinbox": {
      "url": "https://mcp.agentinbox.sh/mcp",
      "transport": "http"
    }
  }
}

Save the file and restart Windsurf. The server will be picked up automatically.

Authentication

AgentInbox uses OAuth with auto-approve — no passwords, no signup forms.

On first use, a browser tab opens briefly for OAuth authorization
The authorization auto-approves instantly — no manual action needed
The browser tab closes and Windsurf stores the token locally
Your agent is assigned a permanent email address (e.g. agent-b4a0@agent-mail.agentinbox.sh)
All future connections reuse the stored credentials — fully automatic

Tip: Same credentials always map to the same agent identity and email address. No configuration needed.

Using AgentInbox in Windsurf

Open Cascade (the AI assistant) and ask your agent to use email. Here are some examples:

“Send an email to hello@example.com introducing yourself”

“Check my inbox for new emails”

“What's my email address?”

Windsurf will automatically invoke the right AgentInbox tool — send_email, get_emails, or get_inbox_address — based on your prompt.

Alternative: API key

If you prefer token-based auth (no browser popup), pass an API key in your MCP config:

.windsurf/mcp.json

{
  "mcpServers": {
    "agentinbox": {
      "url": "https://mcp.agentinbox.sh/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer sk-your-api-key"
      }
    }
  }
}

Replace sk-your-api-key with your actual key. No browser popup required — fully headless.

Pricing

AgentInbox offers a generous free tier to get started.

Plan	Price	Emails
Free	Free	500 / month
Pro	$5 / month	10,000 / month

← Back to guides Full documentation →

Field	Value
Name	agentinbox
Type	HTTP
URL	https://mcp.agentinbox.sh/mcp