Email

v1.0.1Communicationstable

Multi-account IMAP/SMTP email MCP server with 22 tools — read, send, search, organize, thread, attachments, and batch operations. Features connection pooling, rate limiting, retry with backoff, and OAuth2 device-code flow. Written in Go.

aiclaudeemailimapimapflow
Share:
49
Stars
0
Downloads
0
Weekly
0/5

What is Email?

Email is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to multi-account imap/smtp email mcp server with 22 tools — read, send, search, organize, thread, attachments, and batch operations. features connection pooling, rate limiting, retry with backoff, and oa...

Multi-account IMAP/SMTP email MCP server with 22 tools — read, send, search, organize, thread, attachments, and batch operations. Features connection pooling, rate limiting, retry with backoff, and OAuth2 device-code flow. Written in Go.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • send_email
  • search_attachments

Use Cases

IMAP/SMTP email operations
Multi-account email management with 22 tools
kerodkibatu

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.1
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y mcp-server-email

Manual Installation

npx -y mcp-server-email

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Email

email-mcp is a Node.js MCP server that bridges Claude Desktop to the classic Microsoft Outlook desktop application on Windows via COM automation, enabling AI-assisted email management across multiple accounts. It exposes 10 tools covering reading, sending, replying, forwarding, querying, downloading attachments, and viewing calendar events — all without requiring Azure app registration or OAuth configuration. It's ideal for Windows users on corporate networks who want to manage their Outlook inbox through natural language commands.

Prerequisites

  • Windows 10 or Windows 11 operating system
  • Classic Microsoft Outlook desktop application installed and configured with at least one account (the 'new Outlook' for Windows does not support COM and will not work)
  • Node.js 14+ installed
  • An MCP client such as Claude Desktop
1

Ensure classic Outlook is running

The server communicates with Outlook via COM automation (PowerShell scripts). Open classic Outlook and verify at least one email account is configured and connected. The 'new Outlook' redesign does not expose COM and is incompatible.

2

Test the server package with npx

Run the server once with npx to verify it downloads and starts correctly. It will output a startup message if Node.js and the package are accessible.

npx -y github:kerodkibatu/email-mcp
3

Add the server to your MCP client configuration

Open claude_desktop_config.json (or your client's equivalent) and add the email-mcp server entry. No environment variables are required — the server detects Outlook accounts automatically.

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "github:kerodkibatu/email-mcp"]
    }
  }
}
4

Restart Claude Desktop

Close and reopen Claude Desktop to load the new MCP server configuration. The email server should connect on startup.

5

Verify by listing email accounts

Ask Claude to list your email accounts to confirm the connection to Outlook. If Outlook is not running, the server will attempt to launch it automatically.

Email Examples

Client configuration

Claude Desktop configuration for email-mcp. No API keys or environment variables required — authentication is handled through the locally running Outlook instance.

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "github:kerodkibatu/email-mcp"]
    }
  }
}

Prompts to try

Example natural language prompts for managing Outlook email through Claude.

- "List all my configured email accounts"
- "Show me unread emails from the last 24 hours"
- "Send an email to [email protected] with subject 'Meeting Notes' and attach C:\\Users\\Me\\notes.pdf"
- "Reply to the latest email from [email protected] saying I'll review by Friday"
- "Search my inbox for emails about the Q3 budget"
- "Download all attachments from emails received today"
- "What meetings do I have on my calendar this week?"

Troubleshooting Email

Error: 'Cannot connect to Outlook' or COM automation failure

Ensure classic Outlook (not the new redesigned version) is installed and has been opened at least once. Run Outlook as the same user that runs Claude Desktop. If Outlook is not responding, close and reopen it before retrying.

Attachment paths not found when sending email

Use absolute Windows paths with double backslashes (e.g. C:\\Users\\Name\\file.pdf). Tilde (~) expansion is not supported. Ensure the file exists at the specified path before asking Claude to attach it.

npx command fails or package not found

The package is hosted on GitHub, not npm, so the install source is 'github:kerodkibatu/email-mcp'. Ensure you have internet access and that your Node.js version is 14+. Run 'node --version' to check.

Frequently Asked Questions about Email

What is Email?

Email is a Model Context Protocol (MCP) server that multi-account imap/smtp email mcp server with 22 tools — read, send, search, organize, thread, attachments, and batch operations. features connection pooling, rate limiting, retry with backoff, and oauth2 device-code flow. written in go. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Email?

Install via npm with the command: npx -y mcp-server-email. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Email?

Email works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Email free to use?

Yes, Email is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "email": { "command": "npx", "args": ["-y", "mcp-server-email"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Email?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides