AgentMail MCP Server

Connect AgentMail to any MCP-compatible AI client. Three setup options available.

Prerequisites

Get your API key from console.agentmail.to.

Option 1: Remote MCP (Simplest)

No installation required. Connect directly to the hosted MCP server.

URL: https://mcp.agentmail.to

Add to your MCP client configuration:

{
  "mcpServers": {
    "AgentMail": {
      "url": "https://mcp.agentmail.to",
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Option 2: Local npm Package

Run the MCP server locally via npx.

{
  "mcpServers": {
    "AgentMail": {
      "command": "npx",
      "args": ["-y", "agentmail-mcp"],
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Tool Selection

Load only specific tools with the --tools argument:

{
  "mcpServers": {
    "AgentMail": {
      "command": "npx",
      "args": [
        "-y",
        "agentmail-mcp",
        "--tools",
        "send_message,reply_to_message,list_inboxes"
      ],
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Option 3: Local Python Package

Install and run the Python MCP server.

pip install agentmail-mcp

Claude Desktop

Config location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "AgentMail": {
      "command": "/path/to/your/.venv/bin/agentmail-mcp",
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Find your path:

# Activate your virtual environment, then:
which agentmail-mcp

Run Standalone

export AGENTMAIL_API_KEY=your-api-key
agentmail-mcp

Available Tools

Tool	Description
`create_inbox`	Create a new email inbox
`list_inboxes`	List all inboxes
`get_inbox`	Get inbox details by ID
`delete_inbox`	Delete an inbox
`send_message`	Send an email from an inbox
`reply_to_message`	Reply to an existing message
`list_threads`	List email threads in an inbox
`get_thread`	Get thread details and messages
`get_attachment`	Download an attachment
`update_message`	Update message labels

Client Configuration

Cursor, VS Code, Windsurf

Add the same MCP server entry in your client config file:

Cursor: .cursor/mcp.json
VS Code: .vscode/mcp.json
Windsurf: MCP config file

{
  "mcpServers": {
    "AgentMail": {
      "command": "npx",
      "args": ["-y", "agentmail-mcp"],
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Compatible Clients

The AgentMail MCP server works with any MCP-compatible client:

Claude Desktop
Cursor
VS Code
Windsurf
Cline
Goose
Raycast
ChatGPT
Amazon Q
Codex
Gemini CLI
LibreChat
Roo Code
And more...

Example Usage

Once configured, you can ask your AI assistant:

"Create a new inbox for support emails"
"Send an email to john@example.com with subject 'Hello'"
"Check my inbox for new messages"
"Reply to the latest email thanking them"
"List all my email threads"
"Download the attachment from the last message"

Troubleshooting

"Command not found"

Ensure npm/npx is in your PATH, or use the full path:

"command": "/usr/local/bin/npx"

"Invalid API key"

Verify your API key is correct and has the necessary permissions.

Python package not found

Use the full path to the agentmail-mcp executable in your virtual environment:

# Find the path
source /path/to/venv/bin/activate
which agentmail-mcp

agentmail-mcp

Safety Notice

Copy this and send it to your AI assistant to learn