notmuch

Search and read local email messages using the notmuch command-line interface.

2|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/adampoit/ai --skill notmuch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notmuch
Source: https://github.com/adampoit/ai/tree/main/skills/notmuch
Command: npx skills add https://github.com/adampoit/ai --skill notmuch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly find and read emails stored locally on your system using the powerful notmuch command-line interface.

Core Features & Use Cases

  • Search Emails: Find messages based on sender, subject, date, tags, or thread ID.
  • Read Messages: View email content, including headers and full body, in various formats.
  • List Tags: See all tags associated with your emails.
  • Use Case: Quickly locate an email from a specific sender about a particular project or find all unread messages.

Quick Start

Search for all unread emails using the notmuch skill.

Frequently Asked Questions about notmuch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search local email messages using the notmuch command-line interface?

You search local email by filtering messages based on sender, subject, date, tags, or thread ID. Results are provided in either JSON or text format for efficient local email management and retrieval.

Can I read full email content and headers from local mail storage?

Yes, you can read local email content including full headers and body. It retrieves and displays stored messages in various formats, allowing you to view complete message details and threads directly from your local system.

What is the best way to find all unread messages in local email?

The best way to find unread local email is using tag filtering. You can search for messages with the unread tag to quickly locate and read all unread messages stored on your local system.

Does notmuch work for filtering email by specific dates and senders?

Yes, notmuch supports filtering local email by sender, subject, date, and tags. This allows you to quickly locate an email from a specific sender about a particular project or find messages within a specific date range.

How do I list and manage tags associated with my local email?

You can list all tags associated with your local email messages using the dedicated tag listing feature. This helps you understand your tagging structure and use those tags for filtering messages in subsequent searches.

Do I need a specific mail format to use notmuch for local email search?

Notmuch requires emails to be stored locally on your system to search and read them. The Skill interfaces with the notmuch command-line tool to query and retrieve these local mail messages in JSON or text formats.