agentskills.codes
TH

things-mac

by openclawProductivitySource

Interface for managing Things 3 task lists and database from the terminal.

Project ManagementAutomation

Install

mkdir -p .claude/skills/things-mac && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2949" && unzip -o skill.zip -d .claude/skills/things-mac && rm skill.zip

Installs to .claude/skills/things-mac

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Add, update, list, search, or inspect Things 3 todos, inbox, today, projects, areas, and tags on macOS.
103 charsno explicit “when” trigger
Beginner

Key capabilities

  • →List inbox, today, and upcoming tasks
  • →Search local Things 3 database for specific items
  • →Add new todos with notes, tags, and checklist items
  • →Update existing task properties using UUIDs
  • →Inspect projects, areas, and tags

How it works

The tool reads the local Things 3 database directly for queries and uses the Things URL scheme to execute write operations like adding or updating tasks.

Inputs & outputs

You give it
Task title or search query
You get back
Task list or confirmation of update

When to use things-mac

  • →Add tasks to Things 3
  • →Search for existing to-dos
  • →List today's upcoming tasks

About this skill

Things 3 CLI

Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.

Setup

  • Install (recommended, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
  • If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; OpenClaw.app for gateway runs).
  • Optional: set THINGSDB (or pass --db) to point at your ThingsData-* folder.
  • Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.

Read-only (DB)

  • things inbox --limit 50
  • things today
  • things upcoming
  • things search "query"
  • things projects / things areas / things tags

Write (URL scheme)

  • Prefer safe preview: things --dry-run add "Title"
  • Add: things add "Title" --notes "..." --when today --deadline 2026-01-02
  • Bring Things to front: things --foreground add "Title"

Examples: add a todo

  • Basic: things add "Buy milk"
  • With notes: things add "Buy milk" --notes "2% + bananas"
  • Into a project/area: things add "Book flights" --list "Travel"
  • Into a project heading: things add "Pack charger" --list "Travel" --heading "Before"
  • With tags: things add "Call dentist" --tags "health,phone"
  • Checklist: things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
  • From STDIN (multi-line => title + notes):
    • cat <<'EOF' | things add -
    • Title line
    • Notes line 1
    • Notes line 2
    • EOF

Examples: modify a todo (needs auth token)

  • First: get the ID (UUID column): things search "milk" --limit 5
  • Auth: set THINGS_AUTH_TOKEN or pass --auth-token <TOKEN>
  • Title: things update --id <UUID> --auth-token <TOKEN> "New title"
  • Notes replace: things update --id <UUID> --auth-token <TOKEN> --notes "New notes"
  • Notes append/prepend: things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
  • Move lists: things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"
  • Tags replace/add: things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
  • Complete/cancel (soft-delete-ish): things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
  • Safe preview: things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

Delete a todo?

  • Not supported by things3-cli right now (no "delete/move-to-trash" write command; things trash is read-only listing).
  • Options: use Things UI to delete/trash, or mark as --completed / --canceled via things update.

Notes

  • macOS-only.
  • --dry-run prints the URL and does not open Things.

When not to use it

  • →When deleting tasks permanently
  • →When performing operations outside of macOS

Prerequisites

things3-cliFull Disk Access granted to the calling application

Limitations

  • →Delete or move-to-trash operations are not supported
  • →Requires an auth token for update operations

How it compares

This approach provides programmatic CLI access to local data rather than relying on manual interaction with the Things 3 graphical interface.

Compared to similar skills

things-mac side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
things-mac (this skill)12moNo flagsBeginner
linear102moNo flagsBeginner
zapier-workflows118moReviewBeginner
attio-skill-generator77moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by openclaw

View all by openclaw →

gog

openclaw

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

78188

nano-pdf

openclaw

Edit PDFs with natural-language instructions using the nano-pdf CLI.

63300

himalaya

openclaw

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

50191

trello

openclaw

Manage Trello boards, lists, and cards via the Trello REST API.

41205

openai-whisper

openclaw

Local speech-to-text with the Whisper CLI (no API key).

38140

1password

openclaw

Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.

2799

You might also like

linear

lobehub

Linear issue management guide. Use when working with Linear issues, creating issues, updating status, or adding comments. Triggers on Linear issue references (LOBE-xxx), issue tracking, or project management tasks. Requires Linear MCP tools to be available.

10117

zapier-workflows

davila7

Manage and trigger pre-built Zapier workflows and MCP tool orchestration. Use when user mentions workflows, Zaps, automations, daily digest, research, search, lead tracking, expenses, or asks to "run" any process. Also handles Perplexity-based research and Google Sheets data tracking.

11101

attio-skill-generator

kesslerio

Generate use-case-specific Attio workflow skills from templates. Use when creating new skills for lead qualification, deal management, customer onboarding, or custom Attio workflows.

7100

automation-brainstorm

MacroMan5

Interactive workflow design advisor for Power Automate, n8n, Make, Zapier and other platforms. Guides users through planning automation workflows with smart questions about triggers, actions, data flow, and error handling. Uses research sub-agent to find best practices and generates detailed implementation plan. Triggers when user mentions "create workflow", "build flow", "design automation", "need ideas for", or describes workflow requirements without having a complete design.

778

daily-briefing

anthropics

Start your day with a prioritized sales briefing. Works standalone when you tell me your meetings and priorities, supercharged when you connect your calendar, CRM, and email. Trigger with "morning briefing", "daily brief", "what's on my plate today", "prep my day", or "start my day".

761

jira

davila7

Use when the user mentions Jira issues (e.g., "PROJ-123"), asks about tickets, wants to create/view/update issues, check sprint status, or manage their Jira workflow. Triggers on keywords like "jira", "issue", "ticket", "sprint", "backlog", or issue key patterns.

1152

Search skills

Search the agent skills registry