Agent Native

imsg

This skill enables agents to interact with macOS Messages.app through command-line tools to read and send iMessages and SMS.

by LettaOfficial publisher

Identity proven by GitHub's verified organisation badge (letta-ai)

Agents
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode
License
MIT (permissive)
Pin
6785511pinned Oct 9, 2026
Context cost
about 490 tokenswhen the skill loads
GitHub stars
148on letta-ai/skills
Scripts
None found

What it does

“iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.”
The author's description, from SKILL.md

Generated summary from the skill's own text

This skill enables agents to interact with macOS Messages.app through command-line tools to read and send iMessages and SMS. It provides commands to list chats, retrieve message history, monitor for new messages, and send messages with optional attachments to phone numbers or chat IDs.

When to use it

  • Agent needs to retrieve message history or list existing chats on macOS
  • Sending iMessages or SMS messages programmatically to phone numbers
  • Monitoring specific conversations for new incoming messages
  • Including file attachments with outgoing messages

When not to

  • Non-macOS environments without Messages.app installed
  • Managing group chat membership or other chat administration tasks
  • Platforms other than macOS

Install

These commands install from the publisher's repository and need no account.

skills CLI

npx skills add letta-ai/skills --skill imsg

Installs from the repository's default branch, which may have changed since the commit we checked.

GitHub CLI 2.90 or later

gh skill install letta-ai/skills imsg@6785511e7d3913d9ec598435a77ae637cd45fc89

Installs the commit we checked (6785511).

Copy by hand

Download the folder at 6785511 and put it in .claude/skills/imsg for Claude Code and in .agents/skills/imsg for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.

Skill folder on GitHub at 6785511

Copy for your agent

A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.

Prompt

Install the agent skill "imsg" by Letta.

Source, pinned to commit 6785511e7d3913d9ec598435a77ae637cd45fc89:
https://github.com/letta-ai/skills/tree/6785511e7d3913d9ec598435a77ae637cd45fc89/tools/imsg

1. Download that folder at exactly this commit. Do not use the default branch.
2. Copy every file unchanged, keeping the folder structure, into .claude/skills/imsg/ for Claude Code and .agents/skills/imsg/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist.
3. Do not edit the files, and do not run any script in the folder unless I ask you to.
4. When you are done, list the files you copied and where you put them.

Listing and checks: https://www.agentnative.dev/skills/letta/imsg

SKILL.md at the pin

---
name: imsg
description: iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
homepage: https://imsg.to

---

# imsg

Use `imsg` to read and send iMessage/SMS via macOS Messages.app.

## Limitations

- Group chat management (adding/removing members) is not supported
- macOS only

## Requirements

- macOS with Messages.app signed in
- Full Disk Access for terminal
- Automation permission for Messages.app (for sending)

## Common Commands

### List Chats

```bash
imsg chats --limit 10 --json
```

### View History

```bash
# By chat ID
imsg history --chat-id 1 --limit 20 --json

# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json

# Filter by date
imsg history --chat-id 1 --start 2026-01-01T00:00:00Z --json
```

### Watch for New Messages

```bash
imsg watch --chat-id 1 --attachments
imsg watch --chat-id 1 --debounce 250ms
```

### Send Messages

```bash
# Send to phone number
imsg send --to "+14155551212" --text "Hello!"

# Send to existing chat by ID (useful for replies)
imsg send --chat-id 86 --text "Hello!"

# With attachment
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

# Specify service
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms
```

## Service Options

- `--service imessage` — Force iMessage (requires recipient has iMessage)
- `--service sms` — Force SMS (green bubble)
- `--service auto` — Let Messages.app decide (default)

## Safety Rules

1. **Always confirm recipient and message content** before sending
2. **Never send to unknown numbers** without explicit user approval
3. **Be careful with attachments** — confirm file path exists
4. **Rate limit yourself** — don't spam

## Example Workflow

User: "Text mom that I'll be late"

```bash
# 1. Find mom's chat
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mom"))'

# 2. Confirm with user
# "Found Mom at +1555123456. Send 'I'll be late' via iMessage?"

# 3. Send after confirmation
imsg send --to "+1555123456" --text "I'll be late"
```

From letta-ai/skills at 6785511, shown as plain text under its license: MIT (permissive). The license text is in tools/imsg/LICENSE.

View SKILL.md on GitHub at 6785511

Files

4 files, 170 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.

Skill folder on GitHub at 6785511
All 50 skills from Letta

More from Letta

  • acquiring-skills

    Enables the agent to discover and install skills from multiple registries including Hermes Skills Hub, ClawHub, GitHub, and community repositories.

    Agents not labelled yet · about 3.1K tokens · pinned 7 days ago

  • browser-use

    Control a real browser using Chrome DevTools Protocol over WebSocket to navigate pages, interact with UI, fill forms, scrape sites, and capture screenshots or…

    Claude Code, Codex, Cursor +4 · about 3.2K tokens · pinned 7 days ago

  • Context Doctor

    Context Doctor investigates and repairs an agent's context including memory, system prompt, and skills by analyzing observed behavior as evidence.

    Claude Code, Codex, Cursor +3 · about 1K tokens · pinned 7 days ago

  • creating-mods

    This skill creates and edits mod files that extend local Letta instances with tools, slash commands, event handlers, custom model providers, permissions, and…

    Claude Code, Codex, Cursor +4 · about 2.4K tokens · pinned 7 days ago

  • creating-skills

    This skill guides developers in creating modular packages that extend Letta Code agent capabilities with specialized knowledge, workflows, tool integrations…

    Contains scripts

    Claude Code, Codex, Cursor +3 · about 4.5K tokens · pinned 7 days ago

  • curating-memory-palace

    This skill lets the agent maintain a Memory Palace, a structured dashboard view that shows the user what the agent is working on, what it could do next, and…

    Agents not labelled yet · about 3.1K tokens · pinned 7 days ago

All Productivity skills

Related in Productivity

  • suggest-automations

    This skill suggests three relevant automations to users based on their team role and connected apps, then builds the chosen workflow using the build-workflow…

    by n8nOfficial publisher

    Claude Code, Codex, Cursor +3 · about 1.9K tokens · pinned 7 days ago

  • agent-mail-automation

    This skill enables agents to automate email operations through Composio's Agent Mail toolkit via the Rube MCP server.

    by ComposioOfficial publisher

    Claude Code, Codex, Cursor +3 · about 700 tokens · pinned 7 days ago

  • inbox-manager

    This skill transforms an overflowing inbox into a short prioritized list by reading email from Gmail, Microsoft 365, or pasted text, sorting messages into…

    by AnthropicOfficial publisher

    Claude Code, Codex, Cursor +4 · about 2.5K tokens · pinned 7 days ago

  • huggingface-papers

    This skill retrieves and analyzes AI research papers from Hugging Face's paper index and arXiv by fetching paper content as markdown or structured metadata…

    by Hugging FaceOfficial publisher

    Claude Code, Codex, Cursor +4 · about 2.2K tokens · pinned 7 days ago

  • scheduling-tasks

    This skill lets you create and manage scheduled tasks using the letta cron CLI, sending prompts to the agent on a timer for reminders, periodic work, and…

    by LettaOfficial publisher

    Claude Code, Codex, Cursor +4 · about 2.3K tokens · pinned 7 days ago

  • figma-use-figjam

    This skill enables agents to programmatically create and edit FigJam boards using the Figma plugin API via the use_figma MCP tool.

    by FigmaOfficial publisher

    Claude Code · about 1.7K tokens · pinned 7 days ago

Open roles at Letta

4 open roles on the jobs board

See all 4 roles at Letta on the jobs board

The skills listed here are third-party software, collected from public GitHub repositories as a catalog of recent skills and provided as is. Agent Native does not write or control them and is not responsible for any harm, loss or damage caused by installing or using them. Labels and checks describe what we saw at one commit and are not a guarantee. Read a skill's files before you run it. Terms of use