MCP Email Client

Overview

MCP Email Client is a Python-based email management tool that implements the Model Context Protocol (MCP) for seamless integration with Claude Desktop. It provides comprehensive email functionality including configuration management, sending emails, and reading messages with semantic search capabilities.

Features

• 📧 Email Configuration Management: List, add, update, and delete email configurations
• 📨 Send Emails: Send emails using specified configurations
• 📖 Read Emails: Access and read the latest unread emails
• 🔍 Semantic Search: Advanced email search with AI-powered semantic understanding
• 🗃️ Database Storage: Efficient email storage using DuckDB
• 🔌 MCP Integration: Native support for Claude Desktop integration

Installation

From PyPI (Recommended)

pip install mcp-email-client

From Source

1. Clone the repository:

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

2. Install uv (if not already installed):

   Linux/MacOS:

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

   Windows:

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

3. Install dependencies:

   uv sync
   

Quick Start

After installation, you can run the MCP email client directly:

mcp-email-client

Configuration

Configuration example using Claude Desktop

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

For VS Code:

{
    "servers": {
        "mcp-email-client": {
            "type": "stdio",
            "command": "mcp-email-client",
            "args": []
        }
    }
}

For development/local installation:

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

Usage

The MCP Email Client provides several tools that can be used through Claude Desktop:

• List Configurations: View all configured email accounts
• Add Configuration: Add new email account settings
• Update Configuration: Modify existing email configurations
• Delete Configuration: Remove email configurations
• Send Email: Send emails through configured accounts
• Read Emails: Access latest unread emails
• Search Emails: Semantic search through email content

Requirements

• Python 3.12 or higher
• DuckDB for local email storage
• Internet connection for email operations
• Valid email account credentials (IMAP/SMTP)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.

Changelog

v0.1.0

• Initial release
• Basic email configuration management
• Email sending and reading functionality
• MCP integration for Claude Desktop
• Semantic search capabilities