Integrations
Enables email functionality with Gmail accounts, supporting email search, reading email content with threading, viewing statistics, and composing/sending emails securely with TLS.
ClaudePost
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.
Features & Demo
Email Search and Reading
- 📧 Search emails by date range and keywords
- 📅 View daily email statistics
- 📝 Read full email content with threading support
Email Composition and Sending
- ✉️ Send emails with CC recipients support
- 🔒 Secure email handling with TLS
Prerequisites
- Python 3.12 or higher
- A Gmail account (or other email provider)
- If using Gmail:
- Two-factor authentication enabled
- App-specific password generated
- Claude Desktop application
Setup
- Install uv:Copy
- Clone and set up the project:Copy
- Create a
.env
file in the project root:Copy - Configure Claude Desktop:First, make sure you have Claude for Desktop installed. You can install the latest version here. If you already have Claude for Desktop, make sure it's updated to the latest version.Open your Claude Desktop configuration file:Add the following configuration:CopyReplaceCopy
/Users/username
and/path/to/claude-post
with your actual paths.After updating the configuration, restart Claude Desktop for the changes to take effect.
Running the Server
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
Usage Through Claude
You can interact with your emails using natural language commands. Here are some examples:
Search Emails
- "Show me emails from last week"
- "Find emails with subject containing 'meeting'"
- "Search for emails from recruiting@linkedin.com between 2024-01-01 and 2024-01-07"
- "Search sent emails from last month"
Read Email Content
- "Show me the content of email #12345"
- "What's the full message of the last email from HR?"
Email Statistics
- "How many emails did I receive today?"
- "Show me daily email counts for the past week"
Send Emails
- "I want to send an email to john@example.com"
- "Send a meeting confirmation to team@company.com"
Note: For security reasons, Claude will always show you the email details for confirmation before actually sending.
Project Structure
Security Notes
- 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
.env
file
Logging
The application logs detailed information to email_client.log
. Check this file for debugging information and error messages.
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that provides a seamless email management interface through Claude, allowing users to search, read, and send emails directly through natural language conversations.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.Last updated -87JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities including sending, reading, organizing, searching, and managing drafts and labels.Last updated -PythonGPL 3.0
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to access and manage email through IMAP, supporting browsing, searching, reading, and organizing emails while learning user preferences over time.Last updated -2Python
Mailgun MCP Serverofficial
-securityAlicense-qualityA Model Context Protocol server implementation that enables AI assistants like Claude Desktop to interact with Mailgun email services, allowing users to send emails and visualize email delivery statistics through natural language.Last updated -6JavaScriptApache 2.0