Skip to content
MCP server

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.

How AIPoweredBot checks servers