imsg-ingest

Export iMessage conversations into markdown transcripts and JSONL dumps.

20|1|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/rohunvora/cool-claude-skills --skill imsg-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg-ingest
Source: https://github.com/rohunvora/cool-claude-skills/tree/main/skills/imsg-ingest
Command: npx skills add https://github.com/rohunvora/cool-claude-skills --skill imsg-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a standalone iMessage export tool that converts conversations into markdown-ready transcripts and JSONL dumps for AI context, removing manual extraction steps.

Core Features & Use Cases

  • Standalone macOS iMessage export: Reads the local Messages database to export conversations for AI training, auditing, or archiving.
  • Multiple formats & quick exports: Generate markdown transcripts or JSONL exports for selected chats, with quick-export workflows.
  • Context-rich outputs: Includes sender names where available and timestamped messages to support AI prompts.

Quick Start

Run the quick_export script with a contact identifier to produce a markdown transcript of recent iMessages.

Frequently Asked Questions about imsg-ingest

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

FAQPage Schema
How do I export iMessage conversations to markdown for AI context?

Export iMessage conversations to markdown by running the quick_export script with a contact identifier, which reads the local macOS Messages database to produce timestamped, markdown-ready transcripts.

Can I dump iMessage chat history into JSONL format on macOS?

Yes, you can dump iMessage chat history into JSONL format using the provided Python scripts, which parse the local SQLite database to generate structured JSONL exports for AI prompts.

Do I need Full Disk Access to read the iMessage SQLite database?

Yes, you need Full Disk Access on macOS to read the iMessage SQLite database, because the system restricts access to the Messages database for security and privacy reasons.

What is the best way to search and export specific iMessage chats locally?

The best way to search and export specific iMessage chats locally is using this Skill's built-in search and dump capabilities, which query the macOS Messages database to filter conversations by contact.

Why does my iMessage export script fail to access the Messages database?

Your iMessage export script fails to access the Messages database if Full Disk Access is not granted to your terminal or Python environment, preventing reads from the local SQLite database.

Does the iMessage export include sender names and timestamps for AI training?

Yes, the iMessage export includes sender names where available and timestamped messages, providing context-rich markdown transcripts and JSONL outputs suitable for AI training and archiving.