You can run a local MCP server that connects mailbox.org with Claude Desktop, enabling secure access to your email and calendar data from your machine. This setup lets Claude search, read, compose, and manage your mail and events through a private, on-device interface.

How to use

Install and run the MCP server locally, then configure Claude Desktop to connect to it. The server exposes tools to read and search emails, manage calendars, and handle Sieve filtering. With the MCP server running, you can perform actions such as searching your mailbox, reading emails with full content and attachments, sending messages, managing drafts, and checking free/busy times for scheduling.

How to install

Follow these concrete steps to install and start using the mailbox.org MCP server.

git clone <repository-url>
cd mailbox-mcp-server
bun install
bun run build

Create and populate your environment configuration from the example, then edit it with your credentials and preferences.

cp env.example .env

Use an App Password for mailbox.org instead of your main password for security.

Edit the environment file with your credentials and preferred settings.

Required settings

MAILBOX_EMAIL=your-email@mailbox.org 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

Optional: CalDAV configuration (defaults shown)

MAILBOX_CALDAV_URL=https://dav.mailbox.org/

Optional: Enable debug logging

DEBUG=false

Add the MCP server to Claude Desktop so you can connect to it from your workspace.

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

## Additional content to configure and start using

Configure environment variables and server settings to match your mailbox.org account and network environment. The following options are defined to enable IMAP, SMTP, CalDAV, and debugging as needed.

## Configuration and security notes

Security and configuration details ensure your data stays on your machine and is accessed securely by Claude.

## Troubleshooting and notes

If you encounter issues, verify credentials, ensure IMAP/CalDAV access is enabled, and confirm outbound connections to mailbox.org servers from your network.

## Available tools

### search\_emails

Search emails by text, sender, subject, and date range; retrieve headers, body, and attachments.

### get\_email

Retrieve complete email content by UID, including headers and attachments.

### get\_email\_thread

Get conversation threads by message ID.

### get\_folders

List available email folders.

### send\_email

Compose and send emails with HTML/text content and attachments.

### create\_draft

Save email drafts for later editing.

### move\_email

Move emails between folders.

### mark\_email

Mark emails as read/unread or flagged/important.

### delete\_email

Delete emails (move to trash or permanently).

### get\_calendar\_events

Retrieve calendar events within a date range.

### search\_calendar

Search calendar events by keywords.

### get\_free\_busy

Check availability for scheduling.

### list\_sieve\_scripts

List all ManageSieve scripts on the server.

### get\_sieve\_script

Retrieve a specific Sieve script.

### create\_sieve\_filter

Create or update a Sieve filter script.

### delete\_sieve\_script

Delete a Sieve script.

### activate\_sieve\_script

Activate a specific Sieve script.

### check\_sieve\_script

Validate Sieve script syntax without saving.

### get\_sieve\_capabilities

Query ManageSieve server capabilities and extensions.