Mail Client

Provides an MCP server that manages email configurations, sends emails, and reads unread emails.

python

16

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Mail Client MCP is a Python-based email client that exposes a dedicated MCP server you can run locally via the UV runtime. It lets you manage email configurations, send emails, and read unread messages through a standardized MCP interface, making it easy to integrate email capabilities into your Claude Desktop workflows or other MCP clients.

How to use

You run the Mail Client MCP server with your MCP client (for example Claude Desktop) using the UV runtime. Once started, you can perform common email tasks through the MCP endpoints: list existing configurations, add new ones, update or delete configurations, send emails using a chosen configuration, and read the latest unread emails. Use the provided local MCP configuration to start the server, then connect your MCP client to the running process and issue the supported actions.

How to install

Prerequisites: a supported shell or PowerShell and a running internet connection.

Clone the repository and enter the project directory.

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

Install the UV runtime (needed to run MCP servers).

# 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 and sync the project with the UV runtime.

uv sync

Configuration

Configure the MCP server for Claude Desktop using the following example. This maps the local project path into the MCP runtime so you can run the server from your client.

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

Additional configuration for development environments (VS Code)

If you prefer to run the MCP server from VS Code, use a stdio config that points to the uv runtime and the run command for the repository. This example shows how to wire the same project without the Claude Desktop path,

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

Available tools

list_configs

Lists all configured email configurations stored by the server.

add_config

Adds a new email configuration for sending and receiving emails.

update_config

Updates an existing email configuration.

delete_config

Deletes an existing email configuration.

send_email

Sends an email using a specified configuration.

read_unread

Reads the latest unread emails (up to five).