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
`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"
}

MCP Tasks

tasks_search

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Tasks

Related Tools

MCP directory API