version: "1.0.0" name: things description: "Manage Things 3 on macOS: add/update todos and projects via URL scheme, read inbox/today/upcoming, search tasks. Syncs to iOS." requires_bridge: "things"

Things 3

Use the things bridge to manage Things 3 via the things CLI on the host.

When to Use

• User asks to add a task or todo to Things
• Listing inbox, today, upcoming tasks
• Searching tasks or projects
• Managing Things areas and tags

When NOT to Use

• Apple Reminders -> use apple-reminders bridge
• Notion/Trello tasks -> use those skills instead
• Ciana scheduled tasks -> use schedule_task tool

Commands

All commands run via host_execute(bridge="things", command="...").

Read (from DB)

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

Add Todos

things add "Buy milk"
things add "Call mom" --notes "about dinner" --when today
things add "Meeting prep" --deadline 2026-02-15
things add "Book flights" --list "Travel"
things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"

Update Todos (needs auth token)

things search "milk" --limit 5           # Get UUID
things update --id <UUID> "New title"
things update --id <UUID> --completed
things update --id <UUID> --notes "New notes"

Setup (on host)

• Install: GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• Grant Full Disk Access to Terminal/gateway process
• Optional: set THINGS_AUTH_TOKEN env var for update operations
• Uncomment things bridge in config.yaml, restart gateway