list_id
(optional) - ID of project/area to add to (takes priority over listtitle if both provided)
How to use it
list_id is exposed by the Things3 MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list_id tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Things3 MCP
pip install Things3-MCP-server==2.0.6Other tools in Things3 MCP (39)
Create a new project with tags and todos
Create a new todo with full parameter support
Filter by area UUID
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 a random sample of items from Anytime list
Get a random sample of todos from Inbox
Get a random sample of todos, optionally filtered by project
Get recently created items
Get todos from Someday list
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: false) - Include contained items
Maximum number of items to return
(optional) - Title of project/area to add to (must exactly match existing name)
(optional) - Notes for the todo (supports Markdown formatting including checkboxes like - [ ] Task)
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
(optional) - Tags to apply to the todo
Title of the todo
Filter by item type (to-do/project/heading)
Update an existing project
Update an existing todo
(optional) - When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD)