MCP server

Plug myagentmail into Claude Desktop, Cursor, Windsurf, Cline, or any MCP-compatible client. Your AI assistant gets a full set of email tools instantly.

What is MCP?

The Model Context Protocol is an open standard from Anthropic for connecting AI assistants to external tools and data sources. An MCP server runs as a subprocess (or remote service) and exposes a list of tools the LLM can call. We ship one for myagentmail at myagentmail-mcp.

Install

myagentmail-mcp is published on npm. Use npx -y myagentmail-mcp — no global install needed. Each MCP client has its own config file. Below is the setup for the most common ones; the format is identical because MCP is standardized.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "mcpServers": {
    "myagentmail": {
      "command": "npx",
      "args": ["-y", "myagentmail-mcp"],
      "env": {
        "MYAGENTMAIL_KEY": "tk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. The myagentmail tools appear in the tool picker — try "create a new inbox and send a hello to me at [email protected]" and Claude will call create_inbox followed by send_message automatically.

Cursor

Edit ~/.cursor/mcp.json (or your project's .cursor/mcp.json):

{
  "mcpServers": {
    "myagentmail": {
      "command": "npx",
      "args": ["-y", "myagentmail-mcp"],
      "env": { "MYAGENTMAIL_KEY": "tk_your_key_here" }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json with the same shape.

Tools exposed

The server wraps the most useful slice of our REST API as MCP tools. The LLM sees a full JSON schema for each:

• Inboxes — create_inbox, list_inboxes, get_inbox, delete_inbox
• Messages — send_message, reply_to_message, reply_all_to_message, forward_message, list_messages, get_message, mark_message_read, delete_message
• Threads — list_threads, get_thread
• Drafts — create_draft, update_draft, send_draft, list_drafts, delete_draft
• Attachments — list_attachments, download_attachment
• Custom domains — register_domain, verify_domain, list_domains, delete_domain, add_inbox_address
• Workspaces — list_workspaces, create_workspace, issue_workspace_key
• Webhooks — create_webhook, list_webhooks, delete_webhook
• Metrics + utility — get_metrics, verify_email

Source

The server source lives in the myagentmail/mcp directory. It's a thin wrapper — every tool just fetches the matching REST endpoint and returns the JSON.