How do I install the Things Mac skill?

Run npx skillmds@latest add claude-world/things-mac 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.

Is Things Mac safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Things Mac?

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.

Is Things Mac free to use?

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

Who published Things Mac?

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

Things Mac by claude-world — Agent Skill

Name: Things Mac
Author: claude-world

File contents

Things 3 (macOS)

Manage Things 3 tasks using URL schemes (built-in) and things-cli (optional). Requires Things 3 app installed from the Mac App Store.

Prerequisites

Things 3 must be installed: https://culturedcode.com/things/

Option 1: URL scheme (no install, built-in)

open "things:///add?title=<Task Name>"

Option 2: things-cli for richer scripting:

npm install -g things-cli

Verify:

things --version

Commands

URL Scheme (works without any CLI install)

# Add a task to Inbox
open "things:///add?title=Buy+groceries"

# Add with notes and due date
open "things:///add?title=Submit+report&notes=Include+Q1+data&deadline=2026-03-25"

# Add to a specific list/project
open "things:///add?title=Write+tests&list=Work"

# Add with tags
open "things:///add?title=Review+PR&tags=code,review"

# Add to Today
open "things:///add?title=Call+Alice&when=today"

# Show the Today list
open "things:///show?id=today"

# Show Inbox
open "things:///show?id=inbox"

# Show Upcoming
open "things:///show?id=upcoming"

things-cli (if installed)

Command	Description
`things inbox`	List inbox tasks
`things today`	List today's tasks
`things upcoming`	List upcoming tasks
`things search "<query>"`	Search tasks
`things add "<title>"`	Add a task to inbox
`things logbook`	View completed tasks

Usage Examples

Add a task with deadline:

open "things:///add?title=File+taxes&deadline=2026-04-15&notes=Use+last+year+as+reference"

Show today's tasks (opens Things app):

open "things:///show?id=today"

Add task to a project:

open "things:///add?title=Write+unit+tests&list=My+Project&tags=dev"

List today's tasks via CLI (if installed):

things today

Search for a task:

things search "quarterly report"

Rules

Always check that Things 3 is installed: ls /Applications/Things3.app 2>/dev/null || ls "$HOME/Applications/Things3.app" 2>/dev/null
If not installed, direct user to https://culturedcode.com/things/ and stop
URL scheme works without things-cli — always try URL scheme first
URL-encode all parameter values: spaces → +, special chars → %XX
The open command launches the Things app and adds/shows the item
When using URL scheme, Things 3 must be running or it will open automatically
Default destination for new tasks is Inbox unless user specifies a list or when=today
For reading/listing tasks, prefer things-cli if installed; if not, use open to show the relevant list in the app
Keep responses concise: confirm "Added to Things: " in one line

---name: things-macdescription: Add and manage tasks in Things 3 on macOS using URL schemes and the things-cli. Use when user says "add to Things", "show Things inbox", "what's due in Things today", or "search Things tasks".---# Things 3 (macOS)Manage Things 3 tasks using URL schemes (built-in) and `things-cli` (optional).Requires Things 3 app installed from the Mac App Store.## Prerequisites**Things 3** must be installed: https://culturedcode.com/things/**Option 1: URL scheme (no install, built-in)**```bashopen "things:///add?title=<Task Name>"```**Option 2: things-cli for richer scripting:**```bashnpm install -g things-cli```Verify:```bashthings --version```## Commands### URL Scheme (works without any CLI install)```bash# Add a task to Inboxopen "things:///add?title=Buy+groceries"# Add with notes and due dateopen "things:///add?title=Submit+report&notes=Include+Q1+data&deadline=2026-03-25"# Add to a specific list/projectopen "things:///add?title=Write+tests&list=Work"# Add with tagsopen "things:///add?title=Review+PR&tags=code,review"# Add to Todayopen "things:///add?title=Call+Alice&when=today"# Show the Today listopen "things:///show?id=today"# Show Inboxopen "things:///show?id=inbox"# Show Upcomingopen "things:///show?id=upcoming"```### things-cli (if installed)| Command | Description ||---------|-------------|| `things inbox` | List inbox tasks || `things today` | List today's tasks || `things upcoming` | List upcoming tasks || `things search "<query>"` | Search tasks || `things add "<title>"` | Add a task to inbox || `things logbook` | View completed tasks |## Usage Examples**Add a task with deadline:**```bashopen "things:///add?title=File+taxes&deadline=2026-04-15&notes=Use+last+year+as+reference"```**Show today's tasks (opens Things app):**```bashopen "things:///show?id=today"```**Add task to a project:**```bashopen "things:///add?title=Write+unit+tests&list=My+Project&tags=dev"```**List today's tasks via CLI (if installed):**```bashthings today```**Search for a task:**```bashthings search "quarterly report"```## Rules- Always check that Things 3 is installed: `ls /Applications/Things3.app 2>/dev/null || ls "$HOME/Applications/Things3.app" 2>/dev/null`- If not installed, direct user to https://culturedcode.com/things/ and stop- URL scheme works without `things-cli` — always try URL scheme first- URL-encode all parameter values: spaces → `+`, special chars → `%XX`- The `open` command launches the Things app and adds/shows the item- When using URL scheme, Things 3 must be running or it will open automatically- Default destination for new tasks is Inbox unless user specifies a list or `when=today`- For reading/listing tasks, prefer `things-cli` if installed; if not, use `open` to show the relevant list in the app- Keep responses concise: confirm "Added to Things: <task title>" in one line

Frequently asked questions

Things Mac