ClaudePost
About
A seamless email management interface powered by Claude.
Details
- Author
- zilongxue
- Categories
- Communication, Automation, Productivity
Jump to
Setup
Install ClaudePost in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/zilongxue/claude-post
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server that provides a seamless email management interface through Claude. This integration allows you to handle emails directly through natural language conversations with Claude, supporting features like searching, reading, and sending emails securely.
- 📧 Search emails by date range and keywords
- 📅 View daily email statistics
- 📝 Read full email content with threading support
- ✉️ Send emails with CC recipients support
- 🔒 Secure email handling with TLS
- Python 3.12 or higher
- A Gmail account (or other email provider)
- If using Gmail:
- Two-factor authentication enabled
- App-specific passwordgenerated
# MacOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Remember to restart your terminal after installation
# 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 .
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
First, make sure you have Claude for Desktop installed. You can install the latest versionhere. If you already have Claude for Desktop, make sure it's updated to the latest version.
Open your Claude Desktop configuration file:
# 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
{ "mcpServers": { "email": { "command": "/Users/username/.local/bin/uv", "args": [ "--directory", "/path/to/claude-post/src/email_client", "run", "email-client" ] } } }
Replace/Users/usernameand/path/to/claude-postwith your actual paths.
After updating the configuration, restart Claude Desktop for the changes to take effect.
The server runs automatically through Claude Desktop:
- The server will start when Claude launches if configured correctly
- No manual server management needed
- Server stops when Claude is closed
You can interact with your emails using natural language commands. Here are some examples:
- "Show me emails from last week"
- "Find emails with subject containing 'meeting'"
- "Search for emails fromrecruiting@linkedin.combetween 2024-01-01 and 2024-01-07"
- "Search sent emails from last month"
- "Show me the content of email #12345"
- "What's the full message of the last email from HR?"
- "How many emails did I receive today?"
- "Show me daily email counts for the past week"
- "I want to send an email tojohn@example.com"
- "Send a meeting confirmation toteam@company.com"
Note: For security reasons, Claude will always show you the email details for confirmation before actually sending.
claude-post/ ├── pyproject.toml ├── README.md ├── LICENSE ├── .env # Not included in repo ├── .python-version # Python version specification └── src/ └── email_client/ ├── __init__.py ├── __main__.py └── server.py # Main implementation
- Use app-specific passwords instead of your main account password
- For Gmail users:
- Enable 2-Step Verification in your Google Account
- Generate an App Password for this application
- Use the App Password in your.envfile
The application logs detailed information toemail_client.log. Check this file for debugging information and error messages.
This project is licensed under the MIT License - see the LICENSE file for details.
Fast MCP server for Apple Mail with batch JXA (87x faster) and FTS5 search index (700-3500x faster).
Email management via IMAP/SMTP, multi-account
Read, organise and send from the IMAP email accounts you already have. Nothing sends without your approval.
Automate email tasks using SMTP and IMAP protocols.
Local email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP. Apache-2.0 licensed.
An email processing server that uses MongoDB for semantic search and SQLite for efficient storage and retrieval.
Read, search, and manage emails from your inbox, including downloading attachments and listing folders.
Interact with Fastmail email, contacts, and calendar data using the Fastmail API.
Integrate your Fastmail account with AI assistants using the Model Context Protocol.
Query live Gmail data using LLMs via CData's read-only MCP server.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
