How do I install the Rtm skill?

Run npx skillmds@latest add dvcrn/rtm in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rtm?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rtm by dvcrn — Agent Skill

Name: Rtm
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Remember The Milk

CLI tool at scripts/rtm.py for full RTM task management. Stdlib only — no pip dependencies.

Setup

Get API credentials at https://www.rememberthemilk.com/services/api/keys.rtm
Set env vars RTM_API_KEY and RTM_SHARED_SECRET (via OpenClaw config skills.entries.rtm.env)
Run scripts/rtm.py auth — opens a URL, authorize, press Enter. Token saves to ~/.rtm_token

Sub-agents: Env vars are not inherited. Pass them explicitly:

RTM_API_KEY=... RTM_SHARED_SECRET=... python3 scripts/rtm.py <command>

Security

Env vars: RTM_API_KEY and RTM_SHARED_SECRET are required at runtime. Configure via OpenClaw skill env, not hardcoded.
Auth token: Stored as plain text at ~/.rtm_token after interactive auth. This file grants full access to the linked RTM account. Protect it accordingly — restrict file permissions (chmod 600) or remove after use if not needed persistently.
Network: All API calls go to api.rememberthemilk.com and www.rememberthemilk.com only. No other outbound connections.
Permissions: The auth flow requests delete permission (RTM's highest tier) to support task deletion. Use a dedicated API key with minimum needed scope if preferred.

Commands

# Auth (interactive, one-time)
scripts/rtm.py auth

# Lists
scripts/rtm.py lists              # show active lists
scripts/rtm.py lists --all        # include archived

# Tasks
scripts/rtm.py tasks                          # all incomplete
scripts/rtm.py tasks --list LIST_ID           # filter by list
scripts/rtm.py tasks --filter "priority:1"    # RTM filter syntax
scripts/rtm.py tasks --no-notes               # hide notes

# Add (--parse enables Smart Add for dates/tags/priority)
scripts/rtm.py add "Buy groceries" --list LIST_ID --parse
# Smart Add: "Buy milk ^tomorrow #shopping !1" sets due, tag, priority

# Complete / Delete
scripts/rtm.py complete LIST_ID SERIES_ID TASK_ID
scripts/rtm.py delete LIST_ID SERIES_ID TASK_ID

# Priority (1=high, 2=medium, 3=low, N=none)
scripts/rtm.py set-priority LIST_ID SERIES_ID TASK_ID 1

# Due date (natural language parsed by RTM)
scripts/rtm.py set-due LIST_ID SERIES_ID TASK_ID "next friday"

# Move between lists
scripts/rtm.py move FROM_LIST_ID TO_LIST_ID SERIES_ID TASK_ID

# Tags
scripts/rtm.py add-tags LIST_ID SERIES_ID TASK_ID "tag1,tag2"

# Search (RTM filter syntax)
scripts/rtm.py search "tag:work AND status:incomplete"

# Notes
scripts/rtm.py notes-add LIST_ID SERIES_ID TASK_ID "text" --title "Title"
scripts/rtm.py notes-delete NOTE_ID

Task output format

Task output includes IDs needed for write operations:

  Task Name [P1] (due: 2025-03-15) #tag1 #tag2
    list=12345 series=67890 task=11111
    📝 Note Title (note_id=99999)
    Note body text here

RTM filter syntax

Common filters: status:incomplete, priority:1, tag:tagname, due:today, dueBefore:tomorrow, list:Inbox, isTagged:true, addedWithin:"1 week". Combine with AND, OR, NOT.

Full reference: https://www.rememberthemilk.com/help/answers/search/advanced.rtm

Reliability

All API calls have a 15-second timeout with automatic retry (up to 3 attempts with backoff)
Transient network errors are retried; permanent API errors exit immediately
Write operations (add, complete, delete, etc.) auto-create timelines

---name: rtmdescription: Manage Remember The Milk tasks — list, add, complete, delete, search, prioritize, tag, move, and annotate tasks with notes. Use when the user asks about tasks, todos, to-do lists, reminders, or Remember The Milk.---# Remember The MilkCLI tool at `scripts/rtm.py` for full RTM task management. Stdlib only — no pip dependencies.## Setup1. Get API credentials at https://www.rememberthemilk.com/services/api/keys.rtm2. Set env vars `RTM_API_KEY` and `RTM_SHARED_SECRET` (via OpenClaw config `skills.entries.rtm.env`)3. Run `scripts/rtm.py auth` — opens a URL, authorize, press Enter. Token saves to `~/.rtm_token`**Sub-agents:** Env vars are not inherited. Pass them explicitly:```bashRTM_API_KEY=... RTM_SHARED_SECRET=... python3 scripts/rtm.py <command>```## Security- **Env vars:** `RTM_API_KEY` and `RTM_SHARED_SECRET` are required at runtime. Configure via OpenClaw skill env, not hardcoded.- **Auth token:** Stored as plain text at `~/.rtm_token` after interactive auth. This file grants full access to the linked RTM account. Protect it accordingly — restrict file permissions (`chmod 600`) or remove after use if not needed persistently.- **Network:** All API calls go to `api.rememberthemilk.com` and `www.rememberthemilk.com` only. No other outbound connections.- **Permissions:** The auth flow requests `delete` permission (RTM's highest tier) to support task deletion. Use a dedicated API key with minimum needed scope if preferred.## Commands```bash# Auth (interactive, one-time)scripts/rtm.py auth# Listsscripts/rtm.py lists # show active listsscripts/rtm.py lists --all # include archived# Tasksscripts/rtm.py tasks # all incompletescripts/rtm.py tasks --list LIST_ID # filter by listscripts/rtm.py tasks --filter "priority:1" # RTM filter syntaxscripts/rtm.py tasks --no-notes # hide notes# Add (--parse enables Smart Add for dates/tags/priority)scripts/rtm.py add "Buy groceries" --list LIST_ID --parse# Smart Add: "Buy milk ^tomorrow #shopping !1" sets due, tag, priority# Complete / Deletescripts/rtm.py complete LIST_ID SERIES_ID TASK_IDscripts/rtm.py delete LIST_ID SERIES_ID TASK_ID# Priority (1=high, 2=medium, 3=low, N=none)scripts/rtm.py set-priority LIST_ID SERIES_ID TASK_ID 1# Due date (natural language parsed by RTM)scripts/rtm.py set-due LIST_ID SERIES_ID TASK_ID "next friday"# Move between listsscripts/rtm.py move FROM_LIST_ID TO_LIST_ID SERIES_ID TASK_ID# Tagsscripts/rtm.py add-tags LIST_ID SERIES_ID TASK_ID "tag1,tag2"# Search (RTM filter syntax)scripts/rtm.py search "tag:work AND status:incomplete"# Notesscripts/rtm.py notes-add LIST_ID SERIES_ID TASK_ID "text" --title "Title"scripts/rtm.py notes-delete NOTE_ID```## Task output formatTask output includes IDs needed for write operations:``` Task Name [P1] (due: 2025-03-15) #tag1 #tag2 list=12345 series=67890 task=11111 📝 Note Title (note_id=99999) Note body text here```## RTM filter syntaxCommon filters: `status:incomplete`, `priority:1`, `tag:tagname`, `due:today`, `dueBefore:tomorrow`, `list:Inbox`, `isTagged:true`, `addedWithin:"1 week"`. Combine with `AND`, `OR`, `NOT`.Full reference: https://www.rememberthemilk.com/help/answers/search/advanced.rtm## Reliability- All API calls have a 15-second timeout with automatic retry (up to 3 attempts with backoff)- Transient network errors are retried; permanent API errors exit immediately- Write operations (add, complete, delete, etc.) auto-create timelines

Frequently asked questions

Rtm

File contents

Remember The Milk

Setup

Security

Commands

Task output format

RTM filter syntax

Reliability

Related skills

Frequently asked questions

How do I install the Rtm skill?

What does the Rtm skill do?

Is Rtm safe to use?

Which AI agents work with Rtm?

Is Rtm free to use?

Who published Rtm?