Title99/100
Search tasks
The title clearly communicates the tool’s action and subject. Keep it concise.
Description77/100
Search the user's tasks. A bare call returns tasks from every list. Text search is optional. Use `view_lists` to resolve a list to its id.
The description explains the capability, when to use it, and what to expect.
Inputs95/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
completed
Narrow to finished (true) or open (false) tasks. Omit for both.
Clear enough to supply this argument.
listId
Narrow to a single list. Omit to span every list.
Clear enough to supply this argument.
limit
Max results. Defaults to 50, up to 100.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Continue from a previous response's nextCursor, with the same filters. Omit for the first page.
Clear enough to supply this argument.
query
Narrow to tasks matching this text. Every whitespace-separated word must appear in the task's name or note (case-insensitive, any order), so extra words narrow the results rather than widening them — pass distinctive keywords, not a full sentence.
Clear enough to supply this argument.
when › gte
Inclusive lower bound. Omit it to include every earlier day.
Clear enough to supply this argument.
when › lte
Inclusive upper bound. With `completed: false`, "P0D" alone reads today and everything overdue.
Clear enough to supply this argument.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"title": "Search tasks",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Output schema76/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tasks"
],
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"url",
"name",
"completed",
"starred",
"when",
"reminder",
"note",
"duration",
"completedAt",
"createdAt",
"updatedAt",
"source",
"list"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"list": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"emoji"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"emoji": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"when": {
"type": [
"string",
"null"
],
"description": "Calendar date, \"YYYY-MM-DD\", or null for Inbox."
},
"source": {
"type": [
"string",
"null"
]
},
"starred": {
"type": "boolean"
},
"duration": {
"type": [
"number",
"null"
]
},
"reminder": {
"type": [
"string",
"null"
],
"description": "Time of day on the `when` day, \"HH:MM\", or null for none."
},
"completed": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"completedAt": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"nextCursor": {
"type": "string",
"description": "Pass as cursor, with the same filters, to read the next page. Absent on the last page."
}
},
"additionalProperties": false
}