Skip to content
appsgit

Agenticmail MCP Server

Agenticmail MCP Server is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Real email and SMS for AI agents β€” send mail, receive verification codes, drive a real inbox. It has 233 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp.

github.com/agenticmail/agenticmail (opens in a new tab)

Install Agenticmail MCP Server

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "agenticmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "your-value",
        "AGENTICMAIL_MASTER_KEY": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env AGENTICMAIL_API_KEY=your-value --env AGENTICMAIL_MASTER_KEY=your-value --transport stdio agenticmail-mcp-server -- npx -y @agenticmail/mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "agenticmail-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "your-value",
        "AGENTICMAIL_MASTER_KEY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "agenticmail_api_key",
      "description": "AGENTICMAIL_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "agenticmail_master_key",
      "description": "AGENTICMAIL_MASTER_KEY",
      "password": true
    }
  ],
  "servers": {
    "agenticmail-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "${input:agenticmail_api_key}",
        "AGENTICMAIL_MASTER_KEY": "${input:agenticmail_master_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
AGENTICMAIL_API_KEYsecretNoPer-agent API key issued when you create the agent. Scopes every tool call to that agent's mailbox and outbound. Either AGENTICMAILAPIKEY or…
AGENTICMAIL_MASTER_KEYsecretNoMaster key for admin operations (creating agents, listing all accounts, deleting agents). Set this when the MCP client needs admin tools; otherwise prefer the…
AGENTICMAIL_API_URLNoBase URL of the AgenticMail HTTP API. Defaults to http://127.0.0.1:3100 (the port the local CLI binds). Override when the API runs on a different host or port.

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • send_email

    Send email with to, subject, text/html, attachments, CC

  • list_inbox

    List recent inbox messages (paginated, up to 100)

  • read_email

    Read full email content with security analysis

  • reply_email

    Reply (or reply-all) preserving threading

  • forward_email

    Forward an email with original attachments

  • search_emails

    Search by from, subject, body, date range, relay

  • delete_email

    Delete a specific email by UID

  • move_email

    Move email to a folder

  • mark_read

    Mark email as read

  • mark_unread

    Mark email as unread

  • inbox_digest

    Get inbox summary with body previews

  • wait_for_email

    Wait for new email in real time (up to 5 minutes)

  • import_relay_email

    Import email from connected Gmail/Outlook

  • batch_delete

    Delete multiple emails by UID list

  • batch_mark_read

    Mark multiple emails as read

  • batch_mark_unread

    Mark multiple emails as unread

  • batch_move

    Move multiple emails to a folder

  • batch_read

    Read multiple full emails at once

  • manage_contacts

    Add, remove, and list contacts in address book

  • manage_drafts

    Create, list, edit, delete, and send drafts

  • manage_tags

    Create tags, assign to messages, remove, list

  • manage_rules

    Create email filtering rules (auto-move, auto-delete, mark read)

  • manage_signatures

    Create, list, and delete email signatures

  • manage_templates

    Create, list, and delete email templates

  • manage_scheduled

    Schedule emails for future delivery, list, cancel

  • manage_spam

    List spam folder, report spam, mark as not-spam, get spam score

  • manage_pending_emails

    View blocked outbound emails awaiting approval

  • template_send

    Send email using a saved template with variable substitution

  • create_folder

    Create a new IMAP folder

  • list_folder

    List messages in a specific folder

  • list_folders

    List all available folders

  • check_health

    Check AgenticMail server and Stalwart health

  • list_agents

    List all agents with name, email, role

  • message_agent

    Send email to another agent (with priority levels)

  • check_messages

    Check for new messages from agents and externals

  • call_agent

    Call another agent with a task (sync or async)

  • claim_task

    Claim a pending task assigned to you

  • submit_result

    Submit result for a claimed task

  • check_tasks

    Check incoming or outgoing tasks

  • create_account

    Create a new agent with name and role

About Agenticmail MCP Server

The MCP (Model Context Protocol) server for AgenticMail β€” gives any MCP-compatible AI client full email and SMS capabilities.

  • agent
  • ai
  • ai-agent
  • email
  • imap
  • mcp
  • openclaw
  • smtp
  • typescript
  • messaging

FAQ

Agenticmail MCP Server FAQ

Still curious? Email info@appsgit.com.

What is Agenticmail MCP Server?

Agenticmail MCP Server is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Real email and SMS for AI agents β€” send mail, receive verification codes, drive a real inbox. It has 233 GitHub stars, is released under the MIT license and runs locally with npx -y @agenticmail/mcp. The source code is at github.com/agenticmail/agenticmail.

How do I install the Agenticmail MCP Server MCP server?

Add the command npx -y @agenticmail/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Agenticmail MCP Server free?

The server is open source under the MIT license, so running it is free. It needs credentials (AGENTICMAIL_API_KEY and AGENTICMAIL_MASTER_KEY) for the service it connects to, which may require a paid account.

Is Agenticmail MCP Server actively maintained?

The most recent commit was on Sep 13, 2026. The latest release is agenticmail-cli-v0.9.104, published Jun 5, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.