notmuch

notmuch is a skill for Claude Code, Codex from adampoit/ai. It costs 33 tokens per session (334 once invoked), scanned A, original, MIT.

A command-line tool for searching and reading email stored locally by notmuch, an email indexer that organizes messages into searchable threads and tags.

In plain words
What is it for?
It is for searching by sender, recipient, subject, date, thread, or tag, then reading message headers, bodies, and full email threads.
Why use it?
It lets developers find relevant messages and inspect conversations from the terminal without manually browsing a mailbox.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It is for searching by sender, recipient, subject, date, thread, or tag, then reading message headers, bodies, and full email threads.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/adampoit/ai/notmuch
View source ↗ adampoit/ai
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add adampoit/ai --skill notmuch
Clone the repo
git clone --depth 1 https://github.com/adampoit/ai

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for notmuch

README.md
[![agentmods](https://agentmods.dev/badge/skills/adampoit/ai/notmuch/github.svg)](https://agentmods.dev/skills/adampoit/ai/notmuch)
Your own site
<a href="https://agentmods.dev/skills/adampoit/ai/notmuch"><img src="https://agentmods.dev/badge/skills/adampoit/ai/notmuch/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.

agentmods 80×15 button for notmuch

Your own site · 80×15
<a href="https://agentmods.dev/skills/adampoit/ai/notmuch"><img src="https://agentmods.dev/badge/skills/adampoit/ai/notmuch.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 334 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00033 $0.00334
Opus 5.5 $0.00013 $0.00134
Sonnet 5.5 $0.00007 $0.00067
Haiku 4.5 $0.00003 $0.00033

Measured 1mo ago against content hash 6cee1ba55234, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

notmuch 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 1mo 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.

skills/notmuch/SKILL.md · 65 lines

What it actually says

Notmuch

Search local email and inspect message threads with notmuch.

notmuch search --format=json --limit=20 'tag:unread'

Search Threads

Preferred command (machine-readable JSON):

notmuch search --format=json --limit=20 'from:alice subject:"design review" date:2026-02-01..'

Common query terms:

  • from:<email-or-name>
  • to:<email-or-name>
  • subject:<term>
  • tag:<tag-name>
  • date:YYYY-MM-DD..YYYY-MM-DD
  • thread:<thread-id>

Read Messages

Headers-only summary for a thread/query:

notmuch show --format=json --body=false 'thread:0000000000000123'

Full text output:

notmuch show --format=text 'thread:0000000000000123'

Structured output with bodies:

notmuch show --format=json 'thread:0000000000000123'

List Tags

notmuch search --output=tags '*'

Guardrails

Prefer read-only commands in this skill:

  • notmuch search ...
  • notmuch show ...

Avoid mutating commands unless the user explicitly requests them (for example notmuch new, notmuch tag, notmuch insert).

Changes

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.

  1. 1mo ago First seen · 65 lines · 33 tokens per session scan A 6cee1ba55234

Subscribe to this mod's changes

notmuch is a skill published in the GitHub repository adampoit/ai (2 stars, last pushed 1mo ago), licensed MIT. It adds 33 tokens to every session and 334 once invoked, about $0.0001 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.

Related

Other skills, from other repositories

ai-context-primer

Build the context an AI needs to do a task well — the background, constraints, examples, and format it can't guess — so you get a great result on the first try instead of a generic one you have to keep correcting. Use when asked why does AI give me generic answers, how do I give AI better context, my AI results are…

mohitagw15856/pm-claude-skills · 149 tokens

get-more-from-ai

Level up how you actually use AI — from basic one-shot questions to the techniques that get dramatically better results — matched to what you already do. Use when asked how do I get better at using AI, how do power users use AI, I feel like I'm using AI at 10%, or teach me to use AI better. Produces an honest read of…

mohitagw15856/pm-claude-skills · 140 tokens

prompt-debugging

Figure out why a prompt isn't working and fix it — diagnose the actual failure (ambiguity, missing context, wrong format, conflicting instructions) instead of randomly rewording. Use when asked why isn't my prompt working, the AI keeps ignoring my instructions, my prompt gives inconsistent results, or how do I fix…

mohitagw15856/pm-claude-skills · 131 tokens

prompt-library-builder

Build a personal library of reusable prompts for the things you ask AI again and again — so you stop rewriting the same request from scratch. Use when asked help me build a prompt library, save my best prompts, I keep writing the same prompts, or organize my AI prompts. Produces a captured set of your recurring AI…

mohitagw15856/pm-claude-skills · 123 tokens

prompt-optimizer

Diagnose and rewrite an underperforming LLM prompt so it produces reliable, well-structured output. Use when asked to improve a prompt, fix a prompt that gives inconsistent or wrong results, reduce hallucination/refusals, or make output follow a format. Produces a rewritten prompt with a diagnosis of what was failing…

mohitagw15856/pm-claude-skills · 86 tokens

a0-development

Develop or operate Agent Zero: projects, chats, tasks, framework, tools and API/WebUI.

agent0ai/agent-zero · 24 tokens