search-todos

MCP tool from Things MCP by hald

Simple search by title/notes

How to use it

Project documentation lists search-todos for the Things MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Things MCP

$uvx things-mcp
FULL THINGS MCP LISTING

Other tools in Things MCP (28)

add-area

Create a new Area (via AppleScript; Things URL scheme has no add-area command)

add-project

Create a new project

add-todo

Create a new todo

bulk-update-todos

Apply the same update to many todos in a single operation

get

projects / get-areas / get-tags

get-anytime

Get todos from Anytime list

get-areas

Get all areas

get-inbox

Get todos from Inbox

get-logbook

Get completed todos

get-projects

Get all projects

get-recent

Get recently created items

get-someday

Get todos from Someday list, including tasks in Someday projects

get-tag-usage

Report how many items use each tag, sorted by usage; flag unused tags for cleanup

get-tagged-items

Get items with a specific tag

get-tags

Get all tags

get-today

Get todos due today

get-todos

Get todos, optionally filtered by project

get-trash

Get trashed todos

get-upcoming

Get upcoming todos

limit

Maximum number of items to return (default: all; get-logbook defaults to 50)

offset

Number of items to skip from the start (default: 0)

search-advanced

Advanced search with multiple filters

search-items

Search for items in Things

show-item

Show a specific item or list in Things

update

todo (checklist & tags)

update-area

Update an existing Area: rename or set tags (via AppleScript)

update-project

Update an existing project

update-todo

Update an existing todo