add-todo
Create a new todo
How to use it
add-todo is exposed by the Things MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the add-todo tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Things MCP
uvx things-mcpOther tools in Things MCP (39)
Append tags without removing existing ones
Create a new Area (via AppleScript; Things URL scheme has no add-area command)
Create a new project
Filter by area UUID
Apply the same update to many todos in a single operation
Filter by deadline (YYYY-MM-DD)
Get todos from Anytime list
Get all areas
Get todos from Inbox
Get completed todos
Get all projects
Get recently created items
Get todos from Someday list, including tasks in Someday projects
Report how many items use each tag, sorted by usage; flag unused tags for cleanup
Get items with a specific tag
Get all tags
Get todos due today
Get todos, optionally filtered by project
Get trashed todos
Get upcoming todos
(optional, default: true) - Include checklist items
Filter by creation date (e.g., '3d' for last 3 days, '1w' for last week)
Maximum number of items to return (default: all; get-logbook defaults to 50)
Number of items to skip from the start (default: 0)
(optional, default: false) - Return only tags that no item references (cleanup candidates)
Time period (e.g., '3d', '1w', '2m', '1y')
(optional) - Filter todos by project
Advanced search with multiple filters
Search for items in Things
Simple search by title/notes
Show a specific item or list in Things
Filter by start date (YYYY-MM-DD)
Filter by status (incomplete/completed/canceled)
Filter by tag
Replace all tags on the todo
Filter by item type (to-do/project/heading)
Update an existing Area: rename or set tags (via AppleScript)
Update an existing project
Update an existing todo