Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bighardperson avatar

Things Mac

  • 9 installs
  • 33 repo stars
  • Updated April 26, 2026
  • bighardperson/computer-science-skills-collection

things-mac is a Claude skill that manages Things 3 on macOS via the things CLI, reading the local database and adding or updating todos through the URL scheme.

About

This skill manages Things 3 on macOS through the things CLI, reading the local Things database (inbox, today, upcoming, search, projects, areas, tags) and adding or updating todos and projects via the Things URL scheme. A developer uses it when they want an agent to capture tasks into Things or inspect their existing task lists. It matters because it supports a safe dry-run preview and standard task fields like notes, deadlines, tags and checklists. It is macOS-only.

  • Reads the local Things 3 database (inbox, today, upcoming, search, projects, areas, tags)
  • Adds and updates todos and projects through the Things URL scheme via the things CLI
  • Supports --dry-run preview and macOS-only Full Disk Access for DB reads

Things Mac by the numbers

  • 9 all-time installs (skills.sh)
  • Ranked #2,218 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
At a glance

things-mac capabilities & compatibility

Free CLI; requires the Things 3 app on macOS

Capabilities
task management · project management · task capture
Use cases
project management
Platforms
macOS
Runs
Runs locally
Pricing
Free
From the docs

What things-mac says it does

Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
SKILL.md
Prefer safe preview: `things --dry-run add "Title"`
SKILL.md
macOS-only.
SKILL.md
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill things-mac

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs9
repo stars33
Last updatedApril 26, 2026
Repositorybighardperson/computer-science-skills-collection

What it does

Manage Things 3 tasks and projects on macOS by reading the local DB and writing todos via the CLI.

Who is it for?

macOS users who want an agent to capture or list Things 3 tasks and projects

Skip if: Non-macOS platforms; the skill is macOS-only

When should I use this skill?

The user asks to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags

What you get

Tasks captured into or listed out of Things 3 without leaving the terminal

  • Created or updated Things 3 todos and projects
  • Task list output from the local database

By the numbers

  • 7 read commands (inbox, today, upcoming, search, projects, areas, tags)

Files

SKILL.mdMarkdownGitHub ↗

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: 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.
  • 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
  • With tags: things add "Call dentist" --tags "health,phone"
  • Checklist: things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"

Modify (needs auth token)

  • Get ID: things search "milk" --limit 5
  • Title: things update --id <UUID> --auth-token <TOKEN> "New title"
  • Complete: things update --id <UUID> --auth-token <TOKEN> --completed

Notes

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

Related skills

FAQ

What platforms does things-mac support?

macOS only. The skill notes it is macOS-only and reads the local Things database.

How do writes work?

Adds and updates go through the Things URL scheme; the skill recommends a --dry-run preview first, and modify operations need a Things auth token.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.