Email Client
Email Client as MCP Server. Feature: multiple configuration, more than just gmail
What is Email Client?
Email Client is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to email client as mcp server. feature: multiple configuration, more than just gmail
Email Client as MCP Server. Feature: multiple configuration, more than just gmail
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Email Client as MCP Server. Feature: multiple configuration,
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-email-clientConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Email Client
mcp-email-client is a Python-based MCP server that exposes a full email client to AI assistants, supporting multiple account configurations beyond just Gmail. It lets Claude list, read, and send emails across multiple configured accounts — making it useful for AI-driven email workflows, inbox triage, and automated responses from any IMAP/SMTP-compatible mail service.
Prerequisites
- Python 3.8 or higher installed
- uv package manager installed (https://astral.sh/uv)
- Email account credentials (IMAP/SMTP server, username, password or app password) for each account you want to configure
- Repository cloned locally — the server runs from source
- An MCP-compatible AI client such as Claude Desktop or VS Code with MCP extension
Install uv package manager
uv is the required runner for this server. Install it with the one-line installer for your platform.
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Clone the repository and install dependencies
Clone the mcp-email-client repository to your machine, then run 'uv sync' to install all Python dependencies.
git clone https://github.com/gamalan/mcp-email-client.git
cd mcp-email-client
uv syncConfigure your email accounts
Edit the email configuration file in the repository to add your mail account details (IMAP host, SMTP host, username, password). Multiple accounts can be configured and each will be accessible by name.
Add the server to Claude Desktop configuration
Edit your Claude Desktop config file to launch the server via uv. Replace the directory path with the absolute path to your cloned repository.
{
"mcpServers": {
"mcp_email_client": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/mcp-email-client",
"mcp_email_client"
]
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop so it picks up the new server. Ask Claude to list email configurations to confirm the server is connected and your accounts are visible.
Email Client Examples
Client configuration (Claude Desktop)
Claude Desktop configuration block for mcp-email-client running from a local cloned repository.
{
"mcpServers": {
"mcp_email_client": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/mcp-email-client",
"mcp_email_client"
]
}
}
}Prompts to try
Prompts that use the email client tools for reading, managing, and sending emails across configured accounts.
- "List all my email configurations"
- "Read the latest 5 unread emails from my work account"
- "Send an email to [email protected] with subject 'Meeting notes' using my Gmail config"
- "Add a new email configuration for my Outlook account"
- "Delete the email configuration named 'old-account'"Troubleshooting Email Client
Server fails to start with module not found errors
Run 'uv sync' in the repository directory to install all dependencies. Ensure the '--directory' path in your config points to the exact location of the cloned repository.
Email send or read operations fail with authentication errors
For Gmail, you must use an App Password rather than your regular password — enable 2FA on your Google account and generate an App Password at myaccount.google.com/apppasswords. For other providers, check that IMAP/SMTP access is enabled in your account settings.
Multiple accounts not appearing after configuration
Verify that all account entries in the configuration file are correctly formatted. Restart the MCP client after making changes to the configuration file — the server reads config at startup.
Frequently Asked Questions about Email Client
What is Email Client?
Email Client is a Model Context Protocol (MCP) server that email client as mcp server. feature: multiple configuration, more than just gmail It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Email Client?
Follow the installation instructions on the Email Client GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Email Client?
Email Client works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Email Client free to use?
Yes, Email Client is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Email Client Alternatives — Similar Communication Servers
Looking for alternatives to Email Client? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
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.
Set Up Email Client in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Email Client?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.