v0.1.0

A mail client for an AI agent. Search, move, mark, delete and draft over your own index, on your own machine.

docker pull ghcr.io/alexanderkrauck/mailindex-mcp:0.1.0

amd64 and arm64. Note the image tag has no v: the git tag is v0.1.0, the image is 0.1.0, and 0.1 follows its patches.

Try it

git clone https://github.com/alexanderkrauck/mailindex-mcp.git
cd mailindex-mcp && cp .env.example .env
docker compose up -d
claude mcp add --transport http mail http://localhost:8002/mcp

Then ask it to connect a mailbox — add_mail_account is one of the tools, and it will hand you a password-only form rather than asking you to paste a credential into chat.

What is in it

19 MCP tools. Bulk writes selected the same way search is, so clearing eight thousand newsletters is one call rather than eight thousand. Full-text search stemmed across languages over an index that reports its own coverage. Attachment text extracted and OCR'd at sync time. Gmail API and IMAP, multi-tenant, every row owner-scoped.

See CHANGELOG.md for detail and which setup you need to pick a deployment mode.

Pre-1.0. The schema changes between releases and migrations run automatically on start, so pin the image for anything you care about.