Skill

things:jxa

Reads and queries Things 3 data including todos by tag/project/list, projects/areas/tags, and logbook via JXA scripts. Supports markdown export. Read-only.

Javascript

Bash

automation

developer-tools

Install

npx claudepluginhub bendrucker/claude --plugin things

Tool Access

This skill is limited to using the following tools:

Bash(bun ${CLAUDE_PLUGIN_ROOT}/scripts/format-output.ts:*)Skill(mac:jxa-run)Skill(mac:jxa-run Things3:*)Read

Preview

Read and query Things 3 data via JXA.

Supporting Assets

jxa.mdscripts/export-markdown.jssetup.mdtroubleshooting.md

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Parent Repo Stars10

Parent Repo Forks1

Last CommitApr 2, 2026

Actions

View Source View Plugin View on GitHub View README

Things JXA

Read and query Things 3 data via JXA.

Running JXA

To run JXA, use the Skill tool to invoke mac:jxa-run. Do NOT run bun or osascript directly.

Script file

Invoke via: Skill(mac:jxa-run, args: "Things3 ${CLAUDE_PLUGIN_ROOT}/scripts/jxa/query-list.js TMTodayListSource")

Inline expression

Invoke via: Skill(mac:jxa-run, args: "Things3 -e 'var app = Application(\"Things3\"); JSON.stringify(app.lists.byId(\"TMTodayListSource\").toDos().length)'")

Formatting output

Pipe the returned JSON through the formatter for table display:

echo '<json>' | bun ${CLAUDE_PLUGIN_ROOT}/scripts/format-output.ts [--json] [--columns name,status]

Scripts

Script	Usage	Description
`find-todos.js`	`<tag\|project> <name> [--logbook]`	Find todos by tag (across Inbox/Today/Anytime/Upcoming/Someday) or project
`query-list.js`	`<list-id>`	Query todos from any built-in list
`query-logbook.js`	`<start-iso> <end-iso>`	Query logbook with early termination. Full scans of 10k+ items are slow.
`query-metadata.js`	`<projects\|areas\|tags>`	List projects, areas, or tags (tags omit todoCount for performance)
`export-markdown.js`	`[list-id]`	Export a list to markdown checklist

Built-in List IDs

TMInboxListSource (Inbox), TMTodayListSource (Today), TMNextListSource (Anytime), TMCalendarListSource (Upcoming), TMSomedayListSource (Someday), TMLogbookListSource (Logbook)

Repeating Tasks

Detect via midnight heuristic: creationDate at T00:00:00 local time = repeating instance. Templates have activationDate: null. See troubleshooting.md for examples.

Status Values

open, completed, canceled

Reference

jxa.md: Object model and API
setup.md: Development setup
troubleshooting.md: Common issues

Tips

Use properties() for batch reads instead of individual getters
open -g -a "Things3" to launch Things if not running