MCPEmail

ClaudePost provides a Model Context Protocol (MCP) server that lets you manage your email through natural language conversations with Claude. You can search, read, and compose emails securely, all from a seamless chat interface.

How to use

Use ClaudePost with an MCP client to interact with your mailbox through natural language. You can search emails by date ranges or keywords, read full emails with threading, view daily statistics, and compose messages with CC support. When you ask Claude to send, you’ll review the details first for security.

How to install

Prerequisites you need before starting:

• Python 3.12 or higher
• A Gmail account (or another email provider)
• Claude Desktop application

How to install

Install the required tool to run the MCP server locally.

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

# Remember to restart your terminal after installation

How to install

Set up the project, create a Python virtual environment, and install dependencies.

# Clone the repository
git clone https://github.com/ZilongXue/claude-post.git
cd claude-post

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

How to install

Configure your environment with your email credentials.

EMAIL_ADDRESS=your.email@gmail.com
EMAIL_PASSWORD=your-app-specific-password
IMAP_SERVER=imap.gmail.com
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587

How to install

Configure Claude Desktop to connect to the MCP server. Create or edit your Claude Desktop configuration file to include the MCP server entry.

# MacOS
# Path to Claude Desktop config
~/Library/Application Support/Claude/claude_desktop_config.json

# Create the file if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

How to install

Add the MCP server configuration for Claude Desktop so Claude can launch the local server.

{
  "mcpServers": {
    "email": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/claude-post/src/email_client",
        "run",
        "email-client"
      ]
    }
  }
}

How to install

Replace placeholders with your actual paths, then restart Claude Desktop so the changes take effect.

After setup, Claude Desktop will start the server when Claude launches and stop it when Claude closes.

Additional setup notes

The server runs automatically through Claude Desktop once configured. You’ll interact with your mailbox using natural language commands, including searching, reading, and composing emails.

Security and logging

Use app-specific passwords instead of your main account password. For Gmail users, enable 2-Step Verification, generate an App Password, and place it in your environment file. The application logs detailed information to email_client.log for debugging and error messages.

Project structure

The project is organized to separate the MCP server logic from client interactions. Core implementation lives under the email_client package.

Running the server

The server starts automatically when Claude launches if everything is configured correctly, and stops when Claude is closed.

Usage Through Claude

Interact with your emails using natural language. You can perform searches, read full messages, view daily statistics, and compose new emails.

Examples of what you can do

• Search emails by date range or keywords
• Read full email content with threading
• View daily email counts
• Compose and send emails with CC support

Notes on sending emails

For security, Claude will confirm email details before actually sending.

Project notes

The MCP server is designed to work with Claude Desktop and supports TLS for secure communications.

Security and compliance

Follow best practices for credentials, use app-specific passwords, and enable TLS to protect email data in transit.

Available tools

search_emails

Query emails by date range and keywords, returning matching results.

read_email

Read full content of a selected email with threading support.

send_email

Compose and send emails, with optional CC recipients and TLS-secured transmission.

email_stats

Provide daily and historical statistics on received emails.