# claude-post

> MCP Server

ClaudePost is a Model Context Protocol server enabling email management through Claude, allowing users to search, read, compose, and send emails using natural language conversations securely. ClaudePost is a Model

## Overview

- **Category:** Productivity
- **Language:** Python
- **Stars:** 114
- **Forks:** 6
- **Owner:** ZilongXue
- **GitHub:** https://github.com/ZilongXue/claude-post
- **Created:** 2025-01-07T05:55:38+00:00
- **Updated:** 2025-03-28T04:29:18+00:00
- **Source:** https://model-context-protocol.com/servers/email-management-natural-language-claude-integration

## Setup

## Setup

1. Install uv:

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

   # Remember to restart your terminal after installation
   ```

2. Clone and set up the project:

   ```bash
   # 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 .
   ```

3. Create a `.env` file in the project root:

   ```env
   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
   ```

4. Configure Claude Desktop:

   First, make sure you have Claude for Desktop installed. You can install the latest version [here](https://claude.ai/download). If you already have Claude for Desktop, make sure it's updated to the latest version.

   Open your Claude Desktop configuration file:

   ```bash
   # MacOS
   ~/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
   ```

   Add the following configuration:

   ```json
   {
     "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 updating the configuration, restart Claude Desktop for the changes to take effect.

## Tools

## Available Tools

1.  Email Search (Search emails by date range and keywords)
2.  Email Reading (View full email content with threading support)
3.  Email Composition (Compose new emails)
4.  Email Sending (Send emails with CC recipients support)
5.  Email Statistics (View daily email statistics)
6.  Secure email handling (Secure email handling with TLS)