home / mcp / claude post mcp server
ClaudePost enables seamless email management through natural language conversations with Claude, offering secure features like email search, reading, and sending.
Configuration
View docs{
"mcpServers": {
"zilongxue-claude-post": {
"command": "/Users/username/.local/bin/uv",
"args": [
"--directory",
"/path/to/claude-post/src/email_client",
"run",
"email-client"
],
"env": {
"SMTP_PORT": "587",
"IMAP_SERVER": "imap.gmail.com",
"SMTP_SERVER": "smtp.gmail.com",
"EMAIL_ADDRESS": "[email protected]",
"EMAIL_PASSWORD": "your-app-specific-password"
}
}
}
}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.
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.
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 protected]
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.
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.
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.
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.
Search emails by date range and keywords, returning matching results with optional subject/content previews.
Fetch and display full email content, including threading context and metadata.
Compose and send an email, including support for CC recipients and TLS security.
Provide daily counts and statistics about received emails.