things3

Read, create, and update Things 3 tasks via things.py, URL Scheme, and SQLite.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/SizhuangHe/claude-code-skills --skill things3-sizhuanghe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things3
Source: https://github.com/SizhuangHe/claude-code-skills/tree/main/skills/things3
Command: npx skills add https://github.com/SizhuangHe/claude-code-skills --skill things3-sizhuanghe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill centralizes and automates interactions with Things 3 on macOS so users can read lists, create and update todos, and run read-only analytics without risking database corruption or manual repetition.

Core Features & Use Cases

  • Read with things.py: Query Today, Upcoming, Inbox, Logbook, projects, areas, tags, and individual todos for reporting or triage.
  • Create and update via URL Scheme: Build and open Things URL Scheme calls for single or batch creation and use auth-token protected update calls for edits and completions.
  • Advanced read-only SQLite queries: Run direct SQL analytics against the local Things database for trends, weekly completions, and project completion rates while enforcing read-only access.
  • Use Case: Triage inbox items, batch-create project todos from a plan, or generate a weekly completion summary grouped by project for a status report.

Quick Start

Create a Things 3 task titled Finish paper draft for tomorrow in the Research project with tags urgent and a 3h estimate in the notes.

Frequently Asked Questions about things3

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

FAQPage Schema
How do I automate Things 3 task creation and updates on macOS?

Automate Things 3 task creation and updates on macOS by building and opening Things URL Scheme calls, using an auth-token for protected edits and batch imports.

Can I run read-only SQLite queries against my Things 3 database for analytics?

Yes, you can run read-only SQLite queries against the local Things database to generate analytics like weekly completion trends and project completion rates without risking corruption.

What do I need to query Things 3 lists like Today and Upcoming using things.py?

To query Things 3 lists like Today and Upcoming using things.py, you need a macOS system with Things 3 installed and a properly configured conda environment.

What is the best way to batch import todos into a Things 3 project?

Batch import todos into a Things 3 project by programmatically generating and triggering multiple Things URL Scheme calls to populate tasks, tags, and notes.

Does writing to Things 3 via the URL Scheme require an auth-token?

Yes, editing or completing existing todos via the Things URL Scheme requires an auth-token to authorize the update calls and protect your task data.