things-mac

Automate reading and writing tasks in the local Things 3 database.

5|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JansenAnalytics/claudex --skill things-mac-jansenanalytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/JansenAnalytics/claudex/tree/main/skills/things-mac
Command: npx skills add https://github.com/JansenAnalytics/claudex --skill things-mac-jansenanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates reading from and writing to the local Things 3 database to manage tasks without switching apps.

Core Features & Use Cases

  • Read-only: inbox, today, upcoming, search; list projects/areas/tags
  • Write operations: add/update tasks via the Things URL scheme; set notes, lists, headings, tags; bring Things to front
  • Use Case: An agent automatically adds a travel task with notes to Things when user asks to plan a trip.

Quick Start

Add a new Things task titled 'Book flights' under the Travel project with notes describing travel dates.

Frequently Asked Questions about things-mac

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate adding tasks to Things 3 on macOS?

Automating Things 3 tasks on macOS is handled by writing data via the Things URL scheme to create projects, areas, headings, and tags. This allows an AI agent to add tasks with notes directly to the local database.

Can I read my Things 3 inbox and upcoming tasks without opening the app?

Reading Things 3 inbox, today, upcoming, and search lists is supported through read operations on the local database. This requires the Things CLI binary to be installed and accessible on your macOS system.

Does automating Things 3 tasks require installing the Things CLI?

Yes, automating Things 3 requires the Things CLI to be installed and accessible as the 'things' binary. You can optionally set a THINGSDB environment path to locate the database if it is not in the default location.

What is the best way to create a Things 3 task with notes using AI?

The best way to create a Things 3 task with notes via AI is using the Things URL scheme for write operations. You can specify the title, project, and notes details, allowing the agent to push the task directly into the local database.

Why is my Things 3 automation not finding the local database?

Things 3 automation fails to find the local database when the THINGSDB path is incorrect or missing. You must ensure the 'things' binary is installed and optionally set the THINGSDB environment variable to locate the database.

Can I use this to bring Things 3 to the front and update existing tasks?

Yes, you can bring Things 3 to the front and update existing tasks using the Things URL scheme. Write operations support updating tasks, setting notes, lists, headings, and tags within the macOS app.