things-mac

Manage Things 3 tasks on macOS using the things CLI tool.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/lehalpaul/agents --skill things-mac-lehalpaul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/lehalpaul/agents/tree/main/skills/things-mac
Command: npx skills add https://github.com/lehalpaul/agents --skill things-mac-lehalpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines task management on macOS by allowing users to interact with the Things 3 application via a command-line interface, simplifying the process of adding, updating, and querying tasks.

Core Features & Use Cases

  • Task Creation: Add new todos with titles, notes, deadlines, and assign them to projects or areas.
  • Task Querying: List tasks from the inbox, today, or upcoming views, and search for specific tasks.
  • Use Case: A user can ask OpenClaw to add "Schedule dentist appointment" to their "Health" project for today, and OpenClaw will use this Skill to add it directly into Things 3.

Quick Start

Use the things-mac skill to add a new todo with the title "Buy groceries" to your inbox.

Frequently Asked Questions about things-mac

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

FAQPage Schema
How do I manage Things 3 tasks from the command line on macOS?

To manage Things 3 tasks via the command line, use a CLI tool that adds, updates, and queries todos, projects, areas, and tags directly from your local Things database.

Can I add todos to specific Things 3 projects or areas using a CLI?

Yes, you can add todos to specific Things 3 projects or areas using the CLI by specifying the title, notes, deadlines, and target project or area during task creation.

How do I query tasks from the Things 3 inbox or today view?

Querying tasks from the Things 3 inbox or today view is done by using the CLI tool to list and search for specific todos across those built-in application views.

Do I need to configure authentication to write tasks to the Things 3 database?

Yes, writing tasks to the Things 3 database requires the things binary to be installed and optionally configured with a database path or authentication token for write operations.

What task management actions are supported for Things 3 on macOS?

Supported task management actions for Things 3 on macOS include adding new todos, updating existing tasks, and querying todos, projects, areas, and tags from the local database.