imessage-inbox

imessage-inbox is a skill for Claude Code from benelser/imessage-tools. It costs 9 tokens per session (120 once invoked), scanned A, original, MIT.

An inbox view for iMessage conversations on a Mac, showing conversation names, recent times, and message previews.

In plain words
What is it for?
It is for listing a chosen number of recent iMessage conversation threads.
Why use it?
It saves the user from opening the Messages app just to see which conversations need attention.

Skill for Claude Code

Written for Claude Code: $ARGUMENTS substitution.

Part of the imessage-tools plugin — 6 skills, 1 hook shipped together

Good fit It is for listing a chosen number of recent iMessage conversation threads.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/benelser/imessage-tools/imessage-inbox
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 benelser/imessage-tools --skill imessage-inbox
Clone the repo
git clone --depth 1 https://github.com/benelser/imessage-tools

Made for: Claude Code.

Or install imessage-tools, the plugin that ships this one along with the rest of its 6 skills, 1 hook.

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 imessage-inbox

README.md
[![agentmods](https://agentmods.dev/badge/skills/benelser/imessage-tools/imessage-inbox.svg)](https://agentmods.dev/skills/benelser/imessage-tools/imessage-inbox)
Your own site
<a href="https://agentmods.dev/skills/benelser/imessage-tools/imessage-inbox"><img src="https://agentmods.dev/badge/skills/benelser/imessage-tools/imessage-inbox.svg" alt="Measured on agentmods" height="20"></a>
Per session 9 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 120 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.00009 $0.00120
Opus 5 $0.00005 $0.00060
Sonnet 5 $0.00002 $0.00024
Haiku 4.5 $0.00001 $0.00012

Measured 7d ago against content hash 8b5a3767bca0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

imessage-inbox 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 7d 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/imessage-inbox/SKILL.md · 19 lines

What it actually says

Show the inbox/conversation list using imessage-tools.

imessage-tools inbox $ARGUMENTS

Default is 15 conversations. Pass a number to change the limit.

The output renders like the iMessage sidebar with resolved contact names, relative timestamps, and message previews. Show the raw output directly to the user — it is already formatted.

Examples:

  • /imessage-inbox — show last 15 threads
  • /imessage-inbox 5 — show last 5 threads
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. 7d ago First seen · 19 lines · 9 tokens per session scan A 8b5a3767bca0

Subscribe to this mod's changes

imessage-inbox is a skill published in the GitHub repository benelser/imessage-tools (2 stars, last pushed 4mo ago), licensed MIT. It adds 9 tokens to every session and 120 once invoked, about $0.0000 per session on Opus 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

apple-notes

Use this skill when the user wants to interact with Apple Notes on macOS - creating, searching, reading, updating, deleting, organizing, or formatting notes and folders. This skill provides access to Apple Notes through MCP tools and includes safe formatting guidance.

sweetrb/apple-notes-mcp · 54 tokens

apple-mail

Use this skill when the user wants to manage Apple Mail on macOS - reading, searching, sending, replying to, forwarding, and organizing emails and mailboxes. This skill provides access to Apple Mail through MCP tools.

sweetrb/apple-mail-mcp · 47 tokens

confirmation-protocol

Foresay-derived confirmation workflow for email operations. Use this skill BEFORE executing archive-mail with vague filters, composeemail (sending mail), deleteemail/moveemail in bulk, or any operation that touches 5+ emails. Show user a structured preview of "what I understood" before taking action, achieving…

PsychQuant/che-apple-mail-mcp · 88 tokens

bulk-operation-preview

Show structured preview of bulk email operations (5+ emails) before execute. Group by thread, flag false-positive candidates, count side-effect scope (files written, attachments downloaded, mailboxes touched). Use after email-search-disambiguation finishes Phase 1, as Phase 2 of the confirmation protocol.

PsychQuant/che-apple-mail-mcp · 64 tokens

email-search-disambiguation

A clarification step for email searches when a person, time period, direction, or scope is unclear. It presents specific possible meanings so the user can choose one.

PsychQuant/che-apple-mail-mcp · 91 tokens

obsidian-skill

Controls Obsidian vaults via the official CLI (1.12+). Reads, creates, appends to, and searches notes. Manages daily notes, tasks, tags, properties, templates, bookmarks, and plugins. Analyzes knowledge graph structure including backlinks, orphans, and unresolved links. Triggers on Obsidian, vault, notes, daily notes…

wizzy15/obsidian-skill · 102 tokens