soenkenils/mailbox-mcp-server

本页由 AI 翻译，技术细节请以原文为准。查看原文

5 stars 7 forks 质量 74 趋势 33MIT

A Model Context Protocol (MCP) server that integrates mailbox.org email and calendar services with Anthropic's Claude Desktop application.

概览

A Model Context Protocol (MCP) server that integrates mailbox.org email and calendar services with Anthropic's Claude Desktop application. This server enables Claude to access, search, and interact with your personal email and calendar data through a secure, locally-hosted interface. - ✅ by text content, sender, subject, and date range - ✅ including headers, body, and attachments - ✅ with conversation grouping - ✅ and navigation (INBOX, Sent, Drafts, etc.) - ✅ and metadata extraction - ✅ with rich content (HTML/text) and attachments - ✅ - save and edit email drafts - ✅ - move emails between folders - ✅ - mark as read/unread, important, etc.

README

以下为原文 README 节选，完整内容请查看原文。

Mailbox.org MCP Server

A Model Context Protocol (MCP) server that integrates mailbox.org email and calendar services with Anthropic’s Claude Desktop application. This server enables Claude to access, search, and interact with your personal email and calendar data through a secure, locally-hosted interface.

Features

Email Integration (IMAP & SMTP)

Reading & Search:

✅ Search emails by text content, sender, subject, and date range
✅ Retrieve complete email content including headers, body, and attachments
✅ Email thread management with conversation grouping
✅ Folder browsing and navigation (INBOX, Sent, Drafts, etc.)
✅ Attachment detection and metadata extraction

Composition & Management:

✅ Send emails with rich content (HTML/text) and attachments
✅ Draft management - save and edit email drafts
✅ Email organization - move emails between folders
✅ Flag management - mark as read/unread, important, etc.
✅ Email deletion - trash or permanent removal

Performance:

✅ Connection pooling for SMTP and IMAP with health monitoring
✅ Session-based caching for improved performance

Calendar Integration (CalDAV)

✅ Retrieve calendar events within specified date ranges
✅ Search calendar events by title, description, location
✅ Free/busy time checking for scheduling
✅ Multi-calendar support and aggregation
✅ Recurring events and exception handling
✅ Connection pooling for CalDAV with automatic retry logic
✅ Session-based caching for improved performance

Email Filter Management (Sieve/ManageSieve)

✅ List and retrieve existing Sieve filter scripts
✅ Create and update email filtering rules with Sieve syntax
✅ Activate/deactivate filter scripts
✅ Delete unwanted filter scripts
✅ Syntax validation before deploying filters
✅ Server capabilities discovery for supported Sieve extensions

Requirements

Node.js 20 or later
A mailbox.org account
Claude Desktop application

Installation

Clone and build the project:

git clone 
cd mailbox-mcp-server
bun install
bun run build

Copy the example environment file and update it with your credentials:
```
cp env.example .env
```
Note: For security, it’s recommended to use an App Password instead of your main account password.

Edit the .env file with your mailbox.org credentials:

# Required settings
[email protected]
MAILBOX_PASSWORD=your-app-specific-password

# Optional: IMAP configuration (defaults shown)
MAILBOX_IMAP_HOST=imap.mailbox.org
MAILBOX_IMAP_PORT=993
MAILBOX_IMAP_SECURE=true

# Optional: SMTP configuration (defaults shown)
MAILBOX_SMTP_HOST=smtp.mailbox.org
MAILBOX_SMTP_PORT=587
MAILBOX_SMTP_SECURE=true

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
     "mcpServers": {
       "mailbox-mcp-server": {
         "command": "node",
         "args": ["/path/to/mailbox-mcp-server/dist/main.js"]
       }
     }
   }