mcp-email-client MCP Server

Use This MCP server To

Manage multiple email account configurations within MCP Send emails programmatically using specified configurations Read the latest unread emails from configured accounts Add, update, or delete email configurations dynamically Integrate email sending and reading into AI workflows Support email management beyond Gmail accounts Enable automated email notifications from MCP agents

README

Mail Client MCP

Overview

Mail Client MCP is a Python-based email client that allows users to manage email configurations, send emails, and read the latest unread emails. It provide MCP for Claude Desktop

Features

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

Installation

Clone the repository:

git clone https://github.com/gamalan/mcp-email-client.git
cd mcp-email-client

Install uv Linux/MacOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Install dependencies:
```
uv sync
```

Configuration

Configuration example using Claude Desktop

{
  "mcpServers": {
    "mcp_email_client": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "D:\\Project\\RepoPath", 
        "mcp_email_client"
      ]
    }
  }
}

or in VsCode

{
    "servers": {
        "any-name": {
            "type": "stdio",
            "command": "/path/to/uv",
            "args": [
                "run",
                "--directory",
                "/path/to/repo",
                "run_mcp_server.py",
            ]
        }
    }
}

mcp-email-client FAQ

How do I add a new email configuration?

Use the MCP server's API to add configurations specifying SMTP/IMAP details.

Can I use this server with email providers other than Gmail?

Yes, it supports multiple email providers beyond Gmail.

How does the server handle unread emails?

It can fetch and read the latest 5 unread emails from configured accounts.

What platforms is the mcp-email-client compatible with?

It runs on Linux, MacOS, and Windows with Python and uv installed.

How do I integrate mcp-email-client with Claude Desktop?

Configure the MCP server in Claude Desktop using the provided JSON example.

Is it possible to update existing email configurations?

Yes, the server supports updating existing email configurations via its API.

What dependencies are required to run this MCP server?

Python, uv tool, and related dependencies installed via uv sync.

Can this server send emails automatically triggered by AI workflows?

Yes, it enables automated email sending within MCP-driven workflows.