tasks_search
Filter and retrieve tasks by status, text, or ID from MCP Tasks server. Use to search for tasks in progress, to-do, backlog, or other statuses with optional term matching and task ID lookup.
Instructions
Search tasks from specific statuses with optional text & ID filtering
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Optional list of task IDs to search for | |
| limit | No | Maximum number of results (only for really large task lists) | |
| source_id | No | Source ID from task_setup() response - Defaults to most recent in the workspace if not provided - Try to always provide it! - If you don't have it, ask the user for a file path and call task_setup() | |
| statuses | No | Specific statuses to get. Gets all if omitted | |
| terms | No | Search terms to filter tasks by text or status (case-insensitive, OR logic, no regex or wildcards) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ids": {
"description": "Optional list of task IDs to search for",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"description": "Maximum number of results (only for really large task lists)",
"minimum": 1,
"type": "integer"
},
"source_id": {
"description": "Source ID from task_setup() response\n- Defaults to most recent in the workspace if not provided\n- Try to always provide it!\n- If you don't have it, ask the user for a file path and call task_setup()",
"minLength": 1,
"type": "string"
},
"statuses": {
"description": "Specific statuses to get. Gets all if omitted",
"items": {
"description": "You might need to infer it from the context:\n- \"To Do\" for tasks coming up next (e.g. \"Do X next\")\n- \"In Progress\" for what you'll do now (e.g. \"First do X\")\n- \"Reminders\" instructions for you (the AI) to be constantly reminded of\n- \"Notes\" to collect non-actionable notes",
"enum": [
"In Progress",
"To Do",
"Backlog",
"Done",
"Reminders",
"Notes",
"Deleted"
],
"type": "string"
},
"type": "array"
},
"terms": {
"description": "Search terms to filter tasks by text or status (case-insensitive, OR logic, no regex or wildcards)",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}