Mail Client MCP
Email Client as MCP Server. Feature: multiple configuration, more than just gmail
Overview
Mail Client MCP is a Python-based email client that allows users to manage multiple email configurations, send emails, and read the latest unread emails. It serves as an MCP server for Claude Desktop.
To use Mail Client MCP, clone the repository from GitHub, install the necessary dependencies, and configure it according to your email settings. You can then manage your email configurations and send or read emails through the client.
- List all email configurations - Add new email configurations - Update existing email configurations - Delete email configurations - Send emails using specified configurations - Read the latest 5 unread emails
- Managing multiple email accounts in one client.
- Sending emails programmatically through different configurations.
- Quickly accessing unread emails from various accounts.
Add to your AI client
Use these steps to connect Mail Client MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-email-client-gamalan": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-email-client-gamalan": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-email-client-gamalan": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-email-client-gamalan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-email-client-gamalan": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-email-client-gamalan": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-email-client-gamalan"
]
}
}
}FAQ
Can I use Mail Client MCP with any email provider?
Yes! Mail Client MCP supports multiple email configurations, allowing you to use it with various email providers.
Is Mail Client MCP free to use?
Yes! Mail Client MCP is open-source and free to use.
What programming language is Mail Client MCP written in?
Mail Client MCP is written in Python.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2694,"uuid":"f9f90805-f716-4e23-a715-eedcc631adf4","name":"mcp-email-client","title":"Mail Client MCP","description":"Email Client as MCP Server. Feature: multiple configuration, more than just gmail","avatar_url":"https://avatars.githubusercontent.com/u/1147539?v=4","created_at":"2025-03-13T09:43:10.957Z","updated_at":"2025-03-13T09:51:12.902Z","status":"created","author_name":"gamalan","author_avatar_url":"https://avatars.githubusercontent.com/u/1147539?v=4","tags":"model-context-protocol,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/gamalan/mcp-email-client","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"8\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-22 09:28:12\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]