codefuturist/email

MCP Server

Email MCP Server - SMTP/IMAP email via standard protocols

Email MCP server using standard SMTP/IMAP protocols. Works with any mail server — Gmail, Outlook, self-hosted, etc.

MCP Server

  • Package: @codefuturist/email-mcp
  • Transport: stdio
  • Command: npx @codefuturist/email-mcp stdio

Authentication

Password-based or OAuth2 (experimental for Gmail/Microsoft 365)

VariableRequiredDescription
MCP_EMAIL_ADDRESSYesEmail address
MCP_EMAIL_PASSWORDYesPassword or app password
MCP_EMAIL_IMAP_HOSTYesIMAP server hostname
MCP_EMAIL_SMTP_HOSTYesSMTP server hostname

Available Tools

ToolDescription
send_emailSend email
search_emailsSearch emails
read_emailRead email
list_labelsList labels
schedule_emailSchedule sending

Configuration Example

toml
[[mcp.servers]]
name = "email"
type = "stdio"
command = "npx"
args = ["-y", "@codefuturist/email-mcp"]
timeout_seconds = 60
env = { MCP_EMAIL_ADDRESS = "your-value", MCP_EMAIL_PASSWORD = "your-value", MCP_EMAIL_IMAP_HOST = "your-value", MCP_EMAIL_SMTP_HOST = "your-value" }
tools = []

Notes: 47 tools + 7 prompts. Multi-account via ~/.config/email-mcp/config.toml. Setup wizard: npx @codefuturist/email-mcp setup.