Borrowing it
Nothing to install: this file belongs to friisconsult/imap-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/friisconsult/imap-mcp/main/CLAUDE.mdgit clone --depth 1 https://github.com/friisconsult/imap-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/friisconsult/imap-mcp/claude-md)<a href="https://agentmods.dev/instructions/friisconsult/imap-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/friisconsult/imap-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/friisconsult/imap-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/friisconsult/imap-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01158 | $0.01158 |
| Opus 5.5 | $0.00463 | $0.00463 |
| Sonnet 5.5 | $0.00232 | $0.00232 |
| Haiku 4.5 | $0.00116 | $0.00116 |
Grade A, and why
imap-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 46 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Overview
imap-mcp is a single-file Python MCP server (server.py, FastMCP over stdio) that gives Claude Desktop/Cowork/Code access to plain IMAP/SMTP mailboxes — the accounts not covered by the official Gmail/M365 connectors. There is no package structure: server.py holds all tools, test_server.py the tests, install.py the Claude Desktop registration.
Commands
bash setup.sh # create .venv, install deps, register in Claude Desktop (idempotent)
.venv/bin/python server.py --check # validate accounts.json + password resolution without starting the server
.venv/bin/python server.py --set-password "<account>" # store a password in the OS keychain
.venv/bin/python test_server.py # run tests (offline — no mail server, no framework, plain asserts)
On Windows use .\setup.ps1 and .venv\Scripts\python.exe. There is no pytest/lint setup; the test file is a script that prints per-check status and ALL CHECKS PASSED.
Configuration lives in accounts.json (gitignored, plain-text credentials — never commit or print it). accounts.example.json is the template; install.py copies it on first setup and registers the server as imap-mail in Claude Desktop's config.
Architecture: config-level safety gating
The central design decision is that all guardrails live in accounts.json, not in prompts or tool descriptions, so they hold under prompt injection from mail content. Every tool falls into one of three tiers, and any new tool must be gated the same way:
- Read tools (search, get, list, download) — always allowed, but must connect read-only and fetch with
mark_seen=Falseso nothing is even marked read as a side effect. - Write tools (move, trash, create folder, mark, create draft) — must call
_require_writes(account)first, which raisesPermissionErrorunless the account has"allow_writes": true. Deletion does not exist:trash_messagesonly moves to the account'strash_folder(defaultTrash); never add expunge/permanent delete.create_draftonly APPENDs to thedrafts_folder(defaultDrafts) — it composes but can never send, which is why it is a write tool, not a send tool. - Send (
forward_messageonly) — must call_require_send(account, to), which enforces theallow_send_tofnmatch whitelist and requires ansmtpblock. There is deliberately no send-new-mail tool.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 46 lines · 1,158 tokens per session scan A 739d73c314d8
imap-mcp CLAUDE.md is an instructions file published in the GitHub repository friisconsult/imap-mcp (0 stars, last pushed 4mo ago), licensed MIT. It adds 1,158 tokens to every session, about $0.0046 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
imap-mcp CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| imap-mcp CLAUDE.mdfriisconsult/imap-mcp | Instructions file | 0 | 4mo ago | MIT | A | 1,158 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 144k | today | MIT | A | 8,130 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 5,685 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 150k | today | MIT | A | 4,680 | Codex, OpenCode |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 283k | today | MIT | A | 4,342 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 3,153 | GitHub Copilot |