Claude Post

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 conversational interface that stays in sync with your mailbox.

How to use

You interact with the Email MCP server through your MCP client (Claude Desktop integration). Start Claude, then issue natural language commands to perform actions like searching for emails, reading specific messages, checking daily statistics, and sending new messages. You can ask to search by date ranges or keywords, read full emails including threaded content, and compose emails with CC recipients. For security, Claude will confirm the details before sending.

How to install

Prerequisites you need before installing are Python 3.12 or higher, a Gmail account (or another email provider), and Claude Desktop installed and updated.

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

# Remember to restart your terminal after installation
```,

1. Set up the project in a 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 .
```,

2. Create your environment configuration 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
```,

3. Configure Claude Desktop to run the Email MCP server. Create or edit the Claude Desktop config file and add the server entry.

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

Replace /Users/username and /path/to/claude-post with your actual paths. After saving, restart Claude Desktop to apply the changes.

Additional configuration and security

Security notes: Use app-specific passwords for Gmail and keep your credentials out of version control. The TLS-enabled setup helps protect your email data in transit.

The server logs detailed information to a log file named email_client.log for debugging and troubleshooting.

Usage patterns and examples

With the Email MCP server running, use Claude to perform tasks like: searching for emails, reading content, viewing daily statistics, and composing new messages. For example, you can ask Claude to "Search emails from last week" or "Show me the content of email #12345" and Claude will fetch the results through the MCP server.

Troubleshooting and notes

If Claude cannot start the server automatically, verify the path to the uv executable and ensure Claude Desktop points to the correct email client directory. Check the email_client directory for the main implementation at src/email_client/server.py and inspect email_client.log for errors.

Available tools

search_emails

Search emails by date range and keywords, returning matching results with optional subject/content previews.

read_email

Fetch and display full email content, including threading context and metadata.

send_email

Compose and send an email, including support for CC recipients and TLS security.

daily_stats

Provide daily counts and statistics about received emails.