things-mac

Manage Things 3 tasks on macOS via the things CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the management of tasks within the Things 3 application on macOS, allowing for both programmatic addition and modification of tasks, as well as querying of existing task data.

Core Features & Use Cases

  • Task Creation: Add new todos with titles, notes, deadlines, and tags.
  • Task Modification: Update existing tasks, mark them as complete, or cancel them.
  • Data Retrieval: List tasks from the inbox, today's view, upcoming tasks, and search for specific tasks.
  • Project/Area Management: Inspect and organize tasks within projects, areas, and tags.
  • Use Case: A user can ask Kabot to add "Schedule dentist appointment for next Tuesday" to their "Health" project, and Kabot will use this skill to add it to Things 3.

Quick Start

Use the things-mac skill to add a new task called "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 on macOS programmatically?

You can manage Things 3 tasks programmatically on macOS by using the `things` CLI to add, update, and query todos, projects, areas, and tags. This Skill automates task creation and modification directly through command-line interactions.

Can I add todos to specific projects or areas in Things 3 from the command line?

Yes, you can add todos to specific projects or areas in Things 3 from the command line. The `things` CLI supports creating new todos with titles, notes, deadlines, and tags, and organizing them within your existing projects and areas.

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

Yes, an authentication token is optionally required for write operations to the Things 3 database. You must have the `things` binary installed and configure the database path and token to add, update, or cancel tasks.

How do I query existing tasks in Things 3 via the command line?

You query existing tasks in Things 3 via the command line by using the `things` CLI to list tasks from the inbox, today's view, or upcoming list. You can also search for specific tasks and inspect tasks within projects, areas, and tags.

What's the best way to automate task management for Things 3 on macOS?

The best way to automate task management for Things 3 on macOS is using the `things` CLI, which allows programmatic addition, modification, and querying of todos and projects. This enables seamless integration of task creation into your automated workflows.

Why are my write operations failing when using the things CLI with Things 3?

Write operations using the `things` CLI fail when the Things database path and authentication token are not correctly configured. Ensure the `things` binary is installed and your database path and token are properly set for write access.