Skip to main content
Glama
gamalan

mcp-email-client

by gamalan
README.md
# 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

1. Clone the repository:
    ```sh
    git clone https://github.com/gamalan/mcp-email-client.git
    cd mcp-email-client
    ```
2. Install uv
    Linux/MacOS
    ```sh
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```
    Windows
    ```powershell
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    ```

3. Install dependencies:
    ```sh
    uv sync
    ```

## Configuration

Configuration example using Claude Desktop
```json
{
  "mcpServers": {
    "mcp_email_client": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "D:\\Project\\RepoPath", 
        "mcp_email_client"
      ]
    }
  }
}
```

or in VsCode

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

TDQS

C2.9/5.0

Scored across 12 tools

Disambiguation5/5

Each tool has a clear, unique purpose covering configuration CRUD, sending, reading, searching, and embedding generation, with no functional overlap.

Naming Consistency4/5

Most tools follow a verb_noun pattern (list_email_configs, send_email, search_emails), though semantic_search_emails and generate_embeddings are slightly less uniform.

Tool Count5/5

Twelve tools is well-scoped for an email client MCP, providing a focused set without unnecessary bloat.

Completeness4/5

Core email operations and config management are covered, but missing features like deleting emails or marking them as read represent minor gaps.

Maintenance

ActivityInactive
ResponsivenessNo issues