Email Manager

ClaudePost is an email management service that enables natural language interaction through Claude, supporting functions such as searching, reading, and sending emails.

Communication tools Artificial intelligence chatbots #Email management #Natural language #Claude integration #Secure communication .Python

rating : 2.5 points

downloads : 79

update time : 2025-04-28

What is ClaudePost?

ClaudePost is a server based on the Model Context Protocol (MCP) that allows you to easily manage and operate emails by conversing with Claude, supporting functions such as searching, reading, and sending emails.

How to use ClaudePost?

First, install the required dependencies and configure the environment variables. Then, start the Claude desktop application. Finally, interact with the server through natural language commands.

Applicable scenarios

Suitable for individuals or teams that need to process emails efficiently, especially for users who want to reduce manual operations and improve productivity.

Main features

Email searchQuickly locate target emails based on conditions such as keywords and date ranges.

Email readingView the full email content and associated threads, supporting paginated browsing.

Email composition and sendingSupports adding carbon copy recipients and ensures the security of email transmission.

Daily statisticsGenerate a daily email reception volume chart to facilitate tracking of activity trends.

Advantages and limitations

Advantages

Simplify complex email management work.

Improve work efficiency and save time.

Enhance the security and reliability of email processing.

Limitations

Requires a Gmail account or other compatible email services.

May not support some advanced email functions.

The initial setup process is slightly complicated.

How to use ClaudePost

Install dependencies

Download and install Python 3.12 or higher, and ensure that the uv tool is installed.

Clone the repository and initialize

Clone the project code from GitHub and create a virtual environment to install the necessary packages.

Configure environment variables

Edit the `.env` file and fill in your email address, password, and relevant server information.

Configure the Claude desktop client

Add a new MCP server configuration in the Claude desktop application.

Usage examples

Search for emailsDemonstrate how to filter emails using keywords and time ranges.

Send an emailShow how to construct and send a formal email.

Frequently Asked Questions

How to generate an App-specific password?

Does it support other email service providers?

What if I forget my password?

Related resources

ClaudePost official documentation

Project homepage and detailed usage guide.

Claude desktop application download

Download link for the latest version of the Claude desktop client.

🚀 ClaudePost

ClaudePost is a Model Context Protocol (MCP) server that provides a seamless email management interface through natural language conversations with Claude. This integration allows you to handle emails directly via natural language conversations with Claude, supporting functions such as searching, reading, and securely sending emails.

🚀 Quick Start

ClaudePost is a Model Context Protocol (MCP) server, offering a seamless email management interface through natural language conversations with Claude. This integration enables direct email handling via natural - language dialogues with Claude, supporting functions like searching, reading, and securely sending emails.

✨ Features

Email Search and Reading

📧 Search for emails by date range and keywords.
📅 View daily email statistics.
📝 Read full email content, supporting email threads.

Email Composition and Sending

✉️ Support sending emails with carbon copy (CC).
🔒 Use TLS for secure email processing.

📦 Installation

Prerequisites

Python 3.12 or higher.
Gmail account (or other email service providers).
If using Gmail:
- Two - step verification is enabled.
- App - specific password is generated.
Claude desktop application.

Steps

Install uv:

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

# Please restart the terminal after installation.

Clone and set up the project:

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

# Create and activate a virtual environment
uv venv
source .venv/bin/activate  # Use .venv\Scripts\activate for Windows systems

# Install dependencies
uv pip install -e .

Create a .env file in the project root directory:

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

Configure Claude desktop:
- Open the settings interface of Claude Desktop.
- Enable or configure ClaudePost - related options in the plugins or extensions section.
- Ensure that the project path is correctly added to Claude's environment variables, for example:
```
/your/project/path/claude-post
```

💻 Usage Examples

Searching for Emails

Check the content of the emails I received this morning.

Sending an Email

Send an email to Zhang San with the subject 'Project Progress Report'. The content should state that the recent project has been progressing smoothly and ask him to pay attention to relevant details.

📚 Documentation

Project Structure

ClaudePost/
├── email_client.py          # Email processing logic
├── config.py                # Configuration parameter settings
└── log/                    # Log recording folder
    └── email_client.log     # Application log file

Server Operation

Start the server using Claude, ensuring a proper network connection.
Use natural language commands in Claude to interact with emails, such as sending emails or managing the inbox.

Security Tips

Use an app - specific password instead of your personal account password.
For Gmail users:
1. Enable two - step verification.
2. Generate an app password.
3. Use this password in the .env file.