Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| add-todo | Create a new to-do in Things. Supports setting title, notes, when/deadline dates, tags, checklist items, and assigning to projects/areas. Uses the Things URL scheme. |
| add-project | Create a new project in Things. Supports setting title, notes, when/deadline dates, tags, area assignment, and initial to-dos. |
| update-todo | Update an existing to-do in Things. Requires the to-do ID and your Things auth-token. Supports changing title, notes, dates, tags, checklist, list assignment, and status. |
| update-project | Update an existing project in Things. Requires the project ID and your Things auth-token. |
| show | Navigate to and show a list, project, area, tag, or to-do in Things. Built-in list IDs: inbox, today, anytime, upcoming, someday, logbook, tomorrow, deadlines, repeating, all-projects, logged-projects. |
| search | Open the search screen in Things with an optional search query. |
| add-json | Create complex projects and to-dos using the Things JSON command. Supports nested projects with headings, checklist items, and to-dos. The data should be an array of objects with "type" (to-do, project, heading, checklist-item) and "attributes" fields. For updates, include "operation": "update" and "id" fields, and provide auth-token. |
| get-todos | Get to-dos from Things by list, project, area, or tag. Specify exactly one source. Uses AppleScript (macOS only). |
| get-todo-by-id | Get a specific to-do by its ID. Uses AppleScript (macOS only). |
| get-projects | Get all projects from Things. Uses AppleScript (macOS only). |
| get-project-by-id | Get a specific project by its ID. Uses AppleScript (macOS only). |
| get-areas | Get all areas from Things. Uses AppleScript (macOS only). |
| get-tags | Get all tags from Things. Uses AppleScript (macOS only). |
| search-todos | Search for to-dos by title or notes content. Uses AppleScript (macOS only). |
| get-recent-todos | Get recently modified to-dos. Uses AppleScript (macOS only). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |