Remember The Milk

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

Setup

1. Get API credentials at https://www.rememberthemilk.com/services/api/keys.rtm
2. 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:

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