# Things for Raycast

URL: https://www.raycast.com/loris/things

> Search, add and manage Things 3 to-dos and projects on your Mac, with Today, Inbox and Upcoming lists, a menu bar Today list and AI tools.

- Install: raycast://extensions/loris/things
- Author: [Loris Guignard](https://www.raycast.com/loris)
- Installs: 43,086
- Platforms: macOS
- Categories: AI Extensions
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/c4e0f79975a011e16032382f2d1263f712f8b43c/extensions/things/

## Commands

- **Show Today List**: Search and manage your today to-dos
- **Show Inbox List**: Search and manage your inbox to-dos
- **Show Anytime List**: Search and manage your anytime to-dos
- **Show Upcoming List**: Search and manage your upcoming to-dos
- **Show Someday List**: Search and manage your someday to-dos
- **Add New To-Do**: Create to-dos in any list
- **Add New Project**: Create a new project
- **Quick Find**: Search across all areas, projects, and to-dos.
- **Show Today in Menu Bar**: See your Today list in MacOS menu-bar
- **Quick Add To-Do**: Quickly add a new to-do in Things.

## AI tools

- **Get To-Dos**: Get to-dos from Things, optionally filtered by list (inbox/today/anytime/upcoming/someday/logbook/trash), project ID, or area ID. inbox/today/anytime/upcoming/someday return open to-dos; logbook returns completed and canceled to-dos; trash returns all trashed to-dos. WARNING: omitting all filters returns ALL open to-dos — only do this when truly needed.
- **Get To-Do Details**: Get full details of a single to-do including status, notes, tags, and checklist items. Note: checklist items are only returned when the unofficial SQL API is enabled in preferences.
- **Get To-Dos Details**: Get full details (status, notes, tags, checklist items) for multiple to-dos at once (comma-separated IDs). Always prefer this over calling get-todo-details in a loop. Note: checklist items are only returned when the unofficial SQL API is enabled in preferences.
- **Search To-Dos**: Search for open to-dos by keyword (matches title and notes). Use this as the FIRST step when looking for a to-do by name.
- **Get Projects**: Get all open projects in Things. Each project includes its id, name, notes, tags, due date, area, and its nested list of open to-dos. Use get-project-details for the open to-do count.
- **Get Project Details**: Get full details of a single project including status, notes, tags, due date, activation date, area, and open to-do count (completed and canceled to-dos are excluded from the count).
- **Get Areas**: Get all areas in Things. Each area includes its id, name, tags, and its nested list of open to-dos that are not inside a project.
- **Get Area Details**: Get full details of a single area including tags, open project count, and open to-do count. The to-do count only includes to-dos directly in the area, not to-dos inside a project within the area.
- **Get Tags**: Get all tags in Things.
- **Get Lists**: Get all user-created lists (open projects and areas) in Things as a flat array ordered so each area is followed by its projects. Each item has id, name, and type ('area' or 'project').
- **Add To-Do**: Add a new to-do in Things. No auth token required. Key params: title, notes, when (today/tomorrow/evening/anytime/someday/YYYY-MM-DD), deadline (YYYY-MM-DD), tags (comma-separated), list-id (project/area ID), checklist-items (newline-separated). Use add-json to add a to-do with headings or nested structure.
- **Add Project**: Add a new project in Things. No auth token required. Key params: title, notes, when (today/tomorrow/evening/anytime/someday/YYYY-MM-DD), deadline (YYYY-MM-DD), tags (comma-separated), area-id, to-dos (newline-separated to-do titles to add immediately). Use add-json to create a project with headings and nested to-dos in one call.
- **Add Via JSON**: Add items to Things using the JSON URL scheme. Requires an auth token in preferences. This is the ONLY tool that supports creating projects with headings and nested to-dos in a single call. Tags must be arrays of strings, NOT comma-separated strings.
- **Update To-Do**: Update multiple fields of a to-do at once. Requires an auth token in preferences. Key params: title, notes, prepend-notes, append-notes, when (today/tomorrow/evening/anytime/someday/YYYY-MM-DD), deadline (YYYY-MM-DD), tags (replaces all), add-tags (adds without replacing), completed (boolean), canceled (boolean), checklist-items, list-id.
- **Update Project**: Update a project in Things. Requires an auth token in preferences. Key params: title, notes, prepend-notes, append-notes, when, deadline (YYYY-MM-DD), tags (replaces all), add-tags (adds without replacing), area-id (move to a different area), completed (boolean), canceled (boolean).
- **Set To-Do Property**: Set a single property of a to-do via JXA. Does NOT require an auth token. Allowed keys: name, notes, tagNames, dueDate, activationDate, completionDate, cancellationDate. Date values must be YYYY-MM-DD strings. To mark a to-do complete or canceled, use update-todo with completed/canceled instead of setting status here.
- **Delete To-Do**: Delete a to-do in Things. No auth token required. Prompts the user for confirmation before deleting.
- **Delete Project**: Delete a project in Things. No auth token required. Prompts the user for confirmation before deleting. WARNING: deleting a project also moves all its to-dos to the trash.

## README

### Things

Search and manage your Things to-dos from Raycast.

#### Authentication token

The extension uses the [Things URL Scheme](https://culturedcode.com/things/support/articles/2803573/) under the hood to enable certain features, such as scheduling a to-do, or moving a to-do to a project/area. For security reasons, these operations require an authentication token that you can set by following these instructions:

1. Get your authentication token in `Things → Settings → General → Enable Things URLs → Manage`.
2. Paste the token in the extension's preferences.

#### Troubleshooting

If you don't see any of your to-dos in any commands, please make sure Things is installed and running before using this extension. If Things is running, you may need to grant Raycast access to Things in `System Settings > Privacy & Security > Automation > Raycast > Things`.

#### Commands

##### Quick Add To-do

Raycast AI is used to select the deadline, list, tags etc. If Raycast AI is not accessible or user has selected `Don't use AI`
preference, all the quickly created to-do(s) will be sent to Inbox, but the title will still be parsed for assigning deadlines
and list name followed with '#' in title (case-insensitive).

##### Quick Find

Searches across all areas, projects, and to-dos by reading the Things database directly.

> **Note:** This command requires granting Raycast **Full Disk Access** in `System Settings > Privacy & Security > Full Disk Access`.

**Examples (with AI):**
* Book flights today in my Trips list -> Creates to-do with title "Book flights" classified in "today" and list "Trips".
* Add milk to my groceries list for tomorrow with Errand tag -> Creates to-do with title "Milk" classified in "tomorrow" with list "groceries" and tag "Errand".
* Buy a new car by the end of the year -> Creates to-do with title "Buy a new car" and deadline "20..-12-31".

**Examples (without AI):**
* Complete project -> Creates to-do with title "Complete project" in "Inbox".
