# Claws Mail MCP Plugin

> Claws Mail MCP Plugin is an open-source MCP server for communication. Native Claws Mail plugin exposing your mail client to local AI tools over MCP. It is available on Linux, Windows, self-hosted and API.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, Windows, self-hosted, API
- **Repository:** https://github.com/it-atelier-gn/claws-mail-mcp-plugin
- **MCP Registry name:** io.github.it-atelier-gn/claws-mail-mcp-plugin
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README describes a plugin that runs inside Claws Mail and starts a loopback-only HTTP endpoint speaking JSON-RPC over MCP, protected by a bearer token. Because the server runs in the mail client itself, AI tools operate on the accounts and folders you have already configured in Claws Mail rather than on a separate copy of your mail.

Once connected, a compatible assistant can browse and search messages, read bodies and attachments, save attachments into a dedicated folder, compose, reply and forward, move mail, and change flags in bulk. A read_only setting refuses any tool that changes mail, folders or files, and all file access is confined to one configurable directory.

The project suits Claws Mail users who want an AI assistant to work with local mail without sending it through a hosted connector. Setup covers Claude Code, Claude Desktop, VS Code Copilot Chat and Codex CLI, with prebuilt binaries per Claws Mail version or a build from source.

## Features

- **Loopback-only bearer-token endpoint:** The HTTP MCP endpoint binds to 127.0.0.1 by default and requires a bearer token that the plugin writes to a client config file.
- **Read-only mode:** A configuration switch refuses every tool that would change mail, folders or files.
- **Message search and filtering:** Listing and search tools filter by unread, spam, marked, attachment, tag and date range and report total matches.
- **Attachment handling:** Tools return attachment content up to 8 MiB or save attachments into a confined directory without overwriting files.
- **Bulk flag and move actions:** Flags and folder moves can be applied to up to 1000 messages per call.
- **Spam training integration:** Marking spam can also train an active Bogofilter or SpamAssassin plugin.

## Good for

- Ask an AI assistant to summarise unread messages in a folder
- Find and save invoices or attachments from a date range
- Draft replies or forwards to messages inside Claws Mail
- Bulk-tidy folders by moving or flagging many messages at once

## Tools

- `list_messages`: Lists messages with filters and reports total matches.
- `search_messages`: Searches messages by unread, spam, marked, attachment, tag and date range.
- `read_message`: Returns the text body and a numbered list of attachments.
- `get_attachment`: Returns one attachment's content directly, up to 8 MiB.
- `save_attachment`: Writes an attachment to file_dir without overwriting existing files.
- `set_flags`: Changes flags on up to 1000 messages per call.
- `move_messages`: Moves up to 1000 messages per call.
- `set_flag`: Sets a single flag, including spam.
- `learn_spam`: Marks spam and trains an active Bogofilter or SpamAssassin plugin.
- `compose`: Composes a message, attaching files only from file_dir.
- `export_message`: Exports a message to a path inside file_dir.
- `import_message`: Imports a message from a path inside file_dir.
- `status`: Reports plugin status and version.

## FAQ

### Does the server need to be reachable from the internet?

No. The README says the endpoint is loopback-only at 127.0.0.1, so only AI tools running on the same machine as Claws Mail can reach it.

### Can the assistant change my mail?

By default yes, but setting read_only to 1 makes the plugin refuse every tool that changes mail, folders or files.

### Which Claws Mail versions are supported?

Each release includes Linux and Windows builds for every Claws Mail version listed in the repository's ci/claws-versions.json file.

### How do I connect an AI tool?

After loading the plugin, use the endpoint URL and bearer token from mcp_client.json with the command or config shown for your tool, such as Claude Code or VS Code.

### Is Claws Mail MCP Plugin free?

Yes. Claws Mail MCP Plugin is open source, so you can use and self-host it for free.

### What are the best alternatives to Claws Mail MCP Plugin?

The closest alternatives to Claws Mail MCP Plugin are Mac Mail MCP, mcp4mail, Thunderbird MCP, mcp-mail and Proton Mail.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Mac Mail MCP](https://ai-powered.com/mcp/mac-mail-mcp): Mac Mail MCP is an open-source MCP server for communication.
- [mcp4mail](https://ai-powered.com/mcp/mcp4mail): mcp4mail is an open-source MCP server for communication.
- [Thunderbird MCP](https://ai-powered.com/mcp/thunderbird-mcp): Thunderbird MCP is an open-source MCP server for communication.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [Proton Mail](https://ai-powered.com/mcp/proton-mail): Proton Mail is an open-source MCP server for communication.
- [Thunderbird Cli](https://ai-powered.com/mcp/thunderbird-cli): Thunderbird Cli is an open-source MCP server for communication.
- [Outlook Mac MCP](https://ai-powered.com/mcp/outlook-mac-mcp): Outlook Mac MCP is an open-source MCP server for communication.
- [Langmail MCP for your own Stalwart: email, calendar and contacts](https://ai-powered.com/mcp/langmail-mcp-for-your-own-stalwart-email-calendar-and-contac): Langmail MCP for your own Stalwart: email, calendar and contacts is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/claws-mail-mcp-plugin
