skills.rest
cardmagic
cardmagicCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

messages

Search and browse Apple Messages/iMessage conversations using the messages CLI.

Updated Jan 3, 2026
Search Tags:#search#CLI#conversations#iMessage#fuzzy-search#Messages#local-database
One-click install
npx skills add https://github.com/cardmagic/ai-marketplace --skill messages-cardmagic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: messages
Source: https://github.com/cardmagic/ai-marketplace/tree/main/plugins/messages/skills/messages
Command: npx skills add https://github.com/cardmagic/ai-marketplace --skill messages-cardmagic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a fast way to locate and review messages within Apple Messages/iMessage, reducing time spent scrolling through chat history.

Core Features & Use Cases

  • Fuzzy search across messages, chats, and conversations.
  • Browse recent conversations and identify active contacts.
  • Filter results by sender, date, or conversation to quickly locate specific content.

Quick Start

Use the messages CLI to search for a query, e.g. messages search "dinner plan" or messages recent to review recent chats.

Frequently Asked Questions about messages

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

FAQPage Schema
How do I search iMessage conversations for specific text on macOS?▼

To search iMessage conversations, this Skill uses the messages CLI to perform fuzzy search across local Messages history, letting you find specific text instantly without scrolling through chat history.

Does searching Apple Messages history require Full Disk Access on macOS?▼

Yes, searching Apple Messages history requires Full Disk Access on macOS because the Skill reads local Messages database files, along with Node.js 22+ and the messages CLI installed.

Can I browse recent iMessage chats and identify active contacts?▼

Yes, you can browse recent iMessage chats and identify active contacts by running messages recent, which reviews active conversations from the local Messages history.

How do I filter iMessage search results by sender or date?▼

You filter iMessage search results by sender, date, or conversation to quickly locate specific content within the Messages history using the messages CLI fuzzy search capabilities.

What's the best way to locate a conversation in Apple Messages without scrolling?▼

The best way to locate a conversation in Apple Messages without scrolling is using the messages CLI fuzzy search to find chats and conversations instantly across the local database.

Why does my iMessage search not work even though I have macOS?▼

Your iMessage search may not work if prerequisites are missing: macOS with Apple Messages, Node.js 22+, Full Disk Access enabled, and the messages CLI installed to access the local database.

Related Skills

Explore More Content & Communication Skills→
afel6afel6

imessage

Send and receive iMessage and SMS messages via macOS Messages.app.

Community
Intermediate
takemi-ohamatakemi-ohama
1

data-analyst-export

Export query results to CSV, JSON, Excel, and Markdown formats.

Community
Intermediate
josephofiowajosephofiowa

imessage-search

Search and analyze local macOS iMessage databases with natural language queries.

Community
Intermediate
n0rvynn0rvyn
1

contacts

Search macOS Contacts app for contact details via AppleScript.

Community
Intermediate