ClaudePost

ClaudePost

An MCP server enabling Claude to manage Gmail emails via natural language.

107
Stars
30
Forks
0
Releases

Overview

ClaudePost is a Model Context Protocol (MCP) server that provides a seamless email management interface through Claude. It enables natural language interactions to search, read, and compose emails across providers, with a focus on Gmail. Features include email search by date range and keywords, daily email statistics, and reading full email content with threading support. It also supports composing and sending messages, including CC recipients, with TLS-secured transport for security. The server runs inside Claude Desktop and starts automatically when Claude does, eliminating manual server management. Setup involves installing the uv tool, cloning the project, creating and activating a virtual environment, and installing dependencies. Configuration requires a Gmail account (with 2-step verification and an app-specific password) and a .env file containing EMAIL_ADDRESS, EMAIL_PASSWORD, IMAP_SERVER, SMTP_SERVER, and SMTP_PORT. The README details the project structure (src/email_client/server.py as the main implementation) and shows how Claude Desktop's configuration should reference the uv entry point. It emphasizes security practices and logs to email_client.log for debugging.

Details

Owner
ZilongXue
Language
Python
License
MIT License
Updated
2025-12-07

Features

Email search by date range and keywords

Search emails using date ranges and keyword filters to locate messages quickly.

View daily email statistics

Display daily counts and trends of received/sent emails.

Read full email content with threading support

Retrieve and present complete email bodies, including threading context.

Email composition and sending with CC support

Create and send emails, with optional CC recipients.

TLS-secured email handling

Ensure secure transport for sending and reading emails via TLS.

Audience

Gmail usersInteract with Gmail through Claude using natural language for search, read, and compose/send.
Claude usersManage emails across providers via natural language conversations with Claude.
Developers integrating MCP serversDeploy and customize MCP server deployments within Claude Desktop for email workflows.

Tags

emailMCPClaudeGmailIMAPSMTPTLSthreadingnatural-languageemail-searchemail-reademail-sendClaude-Desktop