timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Search, move, mark, delete and draft your real mail over a self-hosted index.
Skills that teach the AI this kind of work; they work alongside this one
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install mailindex-mcp. Follow https://mcp.popnx.com/i/alexanderkrauck-mailindex-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a mailindex-mcp key (create it on the maker’s site) · 1 setting(s) to fill in (EMAILSERVER_DATABASE_URL) · Install Docker on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server mailindex-mcp for Claude on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mailindex": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "EMAILSERVER_DATABASE_URL", "-e", "EMAILSERVER_AUTH_MODE", "-e", "EMAILSERVER_API_TOKEN", "-e", "CREDENTIAL_ENCRYPTION_KEY", "ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3" ], "env": { "EMAILSERVER_DATABASE_URL": "your-value", "EMAILSERVER_AUTH_MODE": "your-value", "EMAILSERVER_API_TOKEN": "your-value", "CREDENTIAL_ENCRYPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the mailindex-mcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
EMAILSERVER_DATABASE_URL PostgreSQL connection URL. This server keeps its own index and does not run without a database; the repository ships docker-compose files that start one for you.Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"mailindex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"EMAILSERVER_DATABASE_URL",
"-e",
"EMAILSERVER_AUTH_MODE",
"-e",
"EMAILSERVER_API_TOKEN",
"-e",
"CREDENTIAL_ENCRYPTION_KEY",
"ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3"
],
"env": {
"EMAILSERVER_DATABASE_URL": "your-value",
"EMAILSERVER_AUTH_MODE": "your-value",
"EMAILSERVER_API_TOKEN": "your-value",
"CREDENTIAL_ENCRYPTION_KEY": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use mailindex-mcp and tell me what you can do for me, then show me one thing✓ If Claude says it is using mailindex-mcp or shows a mailindex-mcp tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect mailindex-mcp yet
mailindex-mcp runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect mailindex-mcp
Works with Claude Code, with some setup first
You need a mailindex-mcp key (create it on the maker’s site) · 1 setting(s) to fill in (EMAILSERVER_DATABASE_URL) · Install Docker on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server mailindex-mcp for Claude Code on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user mailindex --env EMAILSERVER_DATABASE_URL=your-value --env EMAILSERVER_AUTH_MODE=your-value --env EMAILSERVER_API_TOKEN=your-value --env CREDENTIAL_ENCRYPTION_KEY=your-value -- docker run -i --rm -e EMAILSERVER_DATABASE_URL -e EMAILSERVER_AUTH_MODE -e EMAILSERVER_API_TOKEN -e CREDENTIAL_ENCRYPTION_KEY ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the mailindex-mcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
EMAILSERVER_DATABASE_URL PostgreSQL connection URL. This server keeps its own index and does not run without a database; the repository ships docker-compose files that start one for you.Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user mailindex --env EMAILSERVER_DATABASE_URL=your-value --env EMAILSERVER_AUTH_MODE=your-value --env EMAILSERVER_API_TOKEN=your-value --env CREDENTIAL_ENCRYPTION_KEY=your-value -- docker run -i --rm -e EMAILSERVER_DATABASE_URL -e EMAILSERVER_AUTH_MODE -e EMAILSERVER_API_TOKEN -e CREDENTIAL_ENCRYPTION_KEY ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see mailindex-mcp listed as connected
Use mailindex-mcp and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using mailindex-mcp or shows a mailindex-mcp tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a mailindex-mcp key (create it on the maker’s site) · 1 setting(s) to fill in (EMAILSERVER_DATABASE_URL) · Install Docker on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server mailindex-mcp for Cursor on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mailindex": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "EMAILSERVER_DATABASE_URL", "-e", "EMAILSERVER_AUTH_MODE", "-e", "EMAILSERVER_API_TOKEN", "-e", "CREDENTIAL_ENCRYPTION_KEY", "ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3" ], "env": { "EMAILSERVER_DATABASE_URL": "your-value", "EMAILSERVER_AUTH_MODE": "your-value", "EMAILSERVER_API_TOKEN": "your-value", "CREDENTIAL_ENCRYPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the mailindex-mcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
EMAILSERVER_DATABASE_URL PostgreSQL connection URL. This server keeps its own index and does not run without a database; the repository ships docker-compose files that start one for you.Descriptions are as written by the maker.
In the mailindex-mcp settings, EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use mailindex-mcp and tell me what you can do for me, then show me one thing✓ If Cursor says it is using mailindex-mcp or shows a mailindex-mcp tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a mailindex-mcp key (create it on the maker’s site) · 1 setting(s) to fill in (EMAILSERVER_DATABASE_URL) · Install Docker on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server mailindex-mcp for VS Code on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "mailindex": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "EMAILSERVER_DATABASE_URL", "-e", "EMAILSERVER_AUTH_MODE", "-e", "EMAILSERVER_API_TOKEN", "-e", "CREDENTIAL_ENCRYPTION_KEY", "ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3" ], "env": { "EMAILSERVER_DATABASE_URL": "your-value", "EMAILSERVER_AUTH_MODE": "your-value", "EMAILSERVER_API_TOKEN": "your-value", "CREDENTIAL_ENCRYPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the mailindex-mcp tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
EMAILSERVER_DATABASE_URL PostgreSQL connection URL. This server keeps its own index and does not run without a database; the repository ships docker-compose files that start one for you.Descriptions are as written by the maker.
In the mailindex-mcp settings, EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY, EMAILSERVER_DATABASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use mailindex-mcp and tell me what you can do for me, then show me one thing✓ If VS Code says it is using mailindex-mcp or shows a mailindex-mcp tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user mailindex --env EMAILSERVER_DATABASE_URL=your-value --env EMAILSERVER_AUTH_MODE=your-value --env EMAILSERVER_API_TOKEN=your-value --env CREDENTIAL_ENCRYPTION_KEY=your-value -- docker run -i --rm -e EMAILSERVER_DATABASE_URL -e EMAILSERVER_AUTH_MODE -e EMAILSERVER_API_TOKEN -e CREDENTIAL_ENCRYPTION_KEY ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mailindex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"EMAILSERVER_DATABASE_URL",
"-e",
"EMAILSERVER_AUTH_MODE",
"-e",
"EMAILSERVER_API_TOKEN",
"-e",
"CREDENTIAL_ENCRYPTION_KEY",
"ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3"
],
"env": {
"EMAILSERVER_DATABASE_URL": "your-value",
"EMAILSERVER_AUTH_MODE": "your-value",
"EMAILSERVER_API_TOKEN": "your-value",
"CREDENTIAL_ENCRYPTION_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mailindex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"EMAILSERVER_DATABASE_URL",
"-e",
"EMAILSERVER_AUTH_MODE",
"-e",
"EMAILSERVER_API_TOKEN",
"-e",
"CREDENTIAL_ENCRYPTION_KEY",
"ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3"
],
"env": {
"EMAILSERVER_DATABASE_URL": "your-value",
"EMAILSERVER_AUTH_MODE": "your-value",
"EMAILSERVER_API_TOKEN": "your-value",
"CREDENTIAL_ENCRYPTION_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mailindex": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"EMAILSERVER_DATABASE_URL",
"-e",
"EMAILSERVER_AUTH_MODE",
"-e",
"EMAILSERVER_API_TOKEN",
"-e",
"CREDENTIAL_ENCRYPTION_KEY",
"ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3"
],
"env": {
"EMAILSERVER_DATABASE_URL": "your-value",
"EMAILSERVER_AUTH_MODE": "your-value",
"EMAILSERVER_API_TOKEN": "your-value",
"CREDENTIAL_ENCRYPTION_KEY": "your-value"
}
}
}
}EMAILSERVER_DATABASE_URL required envEMAILSERVER_AUTH_MODE secret required envEMAILSERVER_API_TOKEN secret required envCREDENTIAL_ENCRYPTION_KEY secret required envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
oci: ghcr.io/alexanderkrauck/mailindex-mcp:0.3.3Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account alexanderkrauck, which owns the repo
Code last changed 19 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked: only npm and PyPI packages with a version can be checked
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/alexanderkrauck-mailindex-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: EMAILSERVER_AUTH_MODE, EMAILSERVER_API_TOKEN, CREDENTIAL_ENCRYPTION_KEY
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 19 days ago, and the latest version (0.3.3) reached the registry 19 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker on your computer.
In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls
| This one mailindex-mcp | OpenSEO | Exa | Microsoft Learn MCP | Docs | COTAL actions (cotal.ai) | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | Yes | Yes | Yes | No | No |
| Basic checks | 3/3 | 5/5 | 2/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | MIT | MIT | CC-BY-4.0 | NOASSERTION | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
A mail client for an AI agent. Everything you can do in Thunderbird — search, move, mark, delete, draft — over your own index, on your own machine.
Most email MCP servers forward each question straight to IMAP. That answers "show me my last 10 messages" and falls apart on everything else: SEARCH is inconsistent between providers, it cannot see inside attachments, it never tells the model whether it actually searched everything, and it cannot do a thing about what it finds.
So when you ask an assistant to clear eight thousand newsletters out of your inbox, it tells you that would be eight thousand tool calls and suggests you go and do it by hand in the web interface.
This one keeps its own copy of your mail and acts on it:
delete_mail(account_id=3, participants=["newsletter@example.com", ...])
→ matched: 4147, affected: 4147, to: "[Google Mail]/Bin"
One call. One connection. Six seconds. That is the difference between a search box and a mail client.
A real question against a live index of about 59,000 messages across six accounts. One string is blurred: a case number belonging to a real filing.
| This project | Typical email MCP | |
|---|---|---|
| Can it change anything | Move, mark, delete, draft, manage folders — in bulk, by search | Read-only, or one message per call |
| Search | Own PostgreSQL index, GIN full-text, stemmed across languages | Live IMAP SEARCH per call |
| Result completeness | Exact total_count, signed cursors, per-account coverage | Whatever the folder returned |
| Attachments | Text extracted and indexed at sync time (PDF, DOCX, XLSX, PPTX, OCR) | Base64 into the model's context, or not at all |
| Attachment binaries | Never stored; refetched through a 5-minute signed URL | Stored on disk or inlined |
| Transport | Remote HTTP endpoint | Local stdio process on your machine |
| Setup on the client | Paste a URL | Install a runtime, edit config JSON, store credentials locally |
| Users | Multi-tenant, every row owner-scoped | Single user |
| Tool surface | 22 tools, all annotated | Frequently 40+ |
What it costs you, stated up front. You run PostgreSQL and a container. The index is about 28 MB per 1,000 messages — a 50,000-message archive is roughly 1.5 GB — and the image is 1.25 GB because it carries OCR language data. The first sync downloads every message once; search works on what has arrived while the rest continues in the background, and each account reports its own coverage so the model knows what it has not seen yet.
In exchange your assistant can answer questions about mail from years ago, including text inside attachments, and then act on the answer. None of it leaves your machine.
Five minutes, local only, no accounts to create anywhere.
git clone https://github.com/alexanderkrauck/mailindex-mcp.git
cd mailindex-mcp cp .env.example .env docker compose up -d
Every compose file here pulls ghcr.io/alexanderkrauck/mailindex-mcp — amd64 and arm64, so a Raspberry Pi or an Apple Silicon machine works the same way. Append --build to any of them to compile it yourself instead; expect several minutes, because the image carries OCR language data.
Pin a version for anything you care about. This is pre-1.0: the schema changes between releases and migrations run automatically on start, so an unpinned latest can migrate your database the moment you restart.
MAILINDEX_IMAGE=ghcr.io/alexanderkrauck/mailindex-mcp:0.1.0 docker compose up -d
MAILINDEX_IMAGE works with all three compose files, and belongs in your .env rather than on the command line. Note the image tag has no v — the git tag is v0.1.0, the image is 0.1.0, and 0.1 follows the latest patch of that minor version.
Check it came up:
curl http://localhost:8002/api/v1/health
The default development mode is unauthenticated and Docker binds it to 127.0.0.1 only. It is meant for exactly this: trying the thing out on your own machine.
Do this before connecting a mailbox — it is how you connect one.
claude mcp add --transport http mail http://localhost:8002/mcp
For other clients, point them at http://localhost:8002/mcp over streamable HTTP. Then ask something your inbox search would struggle with — a phrase inside a PDF someone sent you three years ago works well.
Just ask your client — add_mail_account is one of the tools:
Connect my mailbox you@example.com, IMAP imap.example.com, SMTP
smtp.example.com
Do not give it the password. Asked without one, it hands you back a short-lived URL to a form that asks for the password alone and sends it from your browser straight to the server. It never passes through the model, never lands in the conversation transcript your AI provider keeps, and it is the only way that works with clients such as ChatGPT that refuse to transmit secrets.
Use an app password from your provider's security settings, never your account login password. For Gmail, ask it to start the Gmail OAuth flow instead: that uses the Gmail API and survives label changes better. Microsoft 365 and Exchange Online accept no password at all, so ask it to connect a Microsoft mailbox: you sign in at Microsoft and approve what the server may do, exactly as with Gmail (setup).
Or over HTTP, if you prefer a shell
curl -X POST http://localhost:8002/api/v1/accounts \
-H 'Content-Type: application/json' \ -d '{ "name": "personal", "account_name": "you@example.com", "username": "you@example.com", "password": "your-app-password", "host": "imap.example.com", "port": 993, "smtp_host": "smtp.example.com", "smtp_port": 465 }'
Synchronization starts on its own and runs in the background. Search works on what has arrived already — ask "how much of my mail have you indexed so far?" and it will tell you exactly, per account, because every search reports its own coverage rather than pretending to be complete.
Four ways people arrive at this, and the shortest honest path for each.
Everything runs locally, nothing to sign up for.
git clone https://github.com/alexanderkrauck/mailindex-mcp.git
cd mailindex-mcp && cp .env.example .env docker compose up -d # pulls the published image claude mcp add --transport http mail http://localhost:8002/mcp
Add a mailbox with an app password (see below), wait for it to sync, then ask your client something your inbox search would lose. What you need: Docker, and an app password from your provider. What to expect: the first build compiles psycopg2 and pulls ~130 MB of OCR language data, so it takes minutes, not seconds. Auth is off and Docker binds to 127.0.0.1 only — fine here, never expose it.
You need a small VPS and a domain. Caddy gets the TLS certificate for you.
cat > .env <<'ENV'
EMAILSERVER_DOMAIN=mail.example.com POSTGRES_PASSWORD=... EMAILSERVER_API_TOKEN=... CREDENTIAL_ENCRYPTION_KEY=... SESSION_SECRET=... ENV docker compose -f docker-compose.single-user.yml up -d
Every value from openssl rand -base64 32; the API token must be at least 32 characters or the server refuses to start. What you need: a VPS with ~2 GB RAM and disk for roughly 25 MB per 1,000 messages, a domain, and an app password per mailbox. What to expect: works with anything that sends an Authorization header — Claude Code, Cursor, mcp-remote. It will *not* work with the claude.ai or ChatGPT web connectors, which negotiate OAuth and cannot send a static token. If you want those, use the next one.
Google OAuth, so each person signs in as themselves and sees only their own mailboxes.
docker compose -f docker-compose.production.yml up -d
What you need: everything above, plus a Google Cloud OAuth Web application with the two redirect URIs listed under Deployment modes. What to expect: an unverified-app warning until you submit the consent screen, and a 100-user cap while unverified — neither matters at this size.
Set `REGISTRATION_MODE=allowlist`. With
open, any Google account on
earth can register on your server and attach mailboxes, and
ALLOWED_GOOGLE_EMAILSis never read. Tenant isolation still keeps strangers
out of *your* mail, but they get an account on your box. This is the easiest
thing to get wrong on a public host.
Honestly: not yet, and here is exactly what is missing rather than a maybe.
What works today. Run it for one team as a pilot using the Google setup above. Multi-tenancy is real and enforced at the query level — every row is owner-scoped, and ownership comes from the authenticated token rather than anything a caller supplies. Mailbox credentials are encrypted at rest and never returned. Attachment binaries are never stored.
What blocks a company-wide rollout.
| Gap | Why it matters |
|---|---|
| Login is Google OIDC only | No Entra ID, Okta, generic OIDC or SAML. If your directory is not Google, nobody can sign in. |
| No provisioning or deprovisioning | Users self-register; there is no SCIM, no group mapping, and no way to revoke someone's index when they leave. |
| No audit export | Sends are audited; reads, searches and mailbox writes are not, which most compliance reviews ask about. |
| Single Postgres, single container | No HA, no read replicas, no horizontal sync workers. Backup and restore is your pg_dump. |
| Attachment text sits in the database | Retention and legal hold are whatever you build. |
If you are that person: the pilot is genuinely worth running, and the honest pitch internally is "a search index over our own mail, on our own hardware, that an assistant can use" — not "an approved platform".
Signing in to this server grants access to nothing. Each mailbox is connected separately:
begin_gmail_connection, which uses the Gmail API instead and survives label changes better.begin_microsoft_connection. Microsoft accepts neither a password nor an app password for these mailboxes. See Connecting Microsoft 365.Microsoft mailboxes are connected the way Gmail is: you sign in at Microsoft and approve what this server may do, and the server keeps only the resulting refresh token, encrypted. That needs one app registration, made once per ser