Claws Mail MCP Plugin
Native Claws Mail plugin exposing your mail client to local AI tools over MCP
- Pricing
- Open source
- Platforms
- Linux, Windows, self-hosted
- Version
- 2.0.0
- Listing updated
- today
Similar MCP servers
About Claws Mail MCP Plugin
Claws Mail MCP Plugin is an open-source MCP server for communication. It is available on Linux, Windows, self-hosted and API.
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.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
Free, GPL-3.0-or-later licensed open source plugin.
Claws Mail MCP Plugin 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.