asana_search_tasks

Search and filter tasks in an Asana workspace with advanced options like user assignments, due dates, custom fields, and project associations to pinpoint specific tasks efficiently.

Instructions

Search tasks in a workspace with advanced filtering options

Input Schema

Name	Required	Description	Default
`assigned_by_any`	No	Comma-separated list of user IDs
`assigned_by_not`	No	Comma-separated list of user IDs to exclude
`assignee_any`	No	Comma-separated list of user IDs
`assignee_not`	No	Comma-separated list of user IDs to exclude
`commented_on_by_not`	No	Comma-separated list of user IDs to exclude
`completed`	No	Filter for completed tasks
`completed_at_after`	No	ISO 8601 datetime string
`completed_at_before`	No	ISO 8601 datetime string
`completed_on`	No	ISO 8601 date string or null
`completed_on_after`	No	ISO 8601 date string
`completed_on_before`	No	ISO 8601 date string
`created_at_after`	No	ISO 8601 datetime string
`created_at_before`	No	ISO 8601 datetime string
`created_by_any`	No	Comma-separated list of user IDs
`created_by_not`	No	Comma-separated list of user IDs to exclude
`created_on`	No	ISO 8601 date string or null
`created_on_after`	No	ISO 8601 date string
`created_on_before`	No	ISO 8601 date string
`custom_fields`	No	Object containing custom field filters. Keys should be in the format "{gid}.{operation}" where operation can be: - {gid}.is_set: Boolean - For all custom field types, check if value is set - {gid}.value: String\|Number\|String(enum_option_gid) - Direct value match for Text, Number or Enum fields - {gid}.starts_with: String - For Text fields only, check if value starts with string - {gid}.ends_with: String - For Text fields only, check if value ends with string - {gid}.contains: String - For Text fields only, check if value contains string - {gid}.less_than: Number - For Number fields only, check if value is less than number - {gid}.greater_than: Number - For Number fields only, check if value is greater than number Example: { "12345.value": "high", "67890.contains": "urgent" }
`due_at_after`	No	ISO 8601 datetime string
`due_at_before`	No	ISO 8601 datetime string
`due_on`	No	ISO 8601 date string or null
`due_on_after`	No	ISO 8601 date string
`due_on_before`	No	ISO 8601 date string
`followers_not`	No	Comma-separated list of user IDs to exclude
`has_attachment`	No	Filter for tasks with attachments
`is_blocked`	No	Filter for tasks with incomplete dependencies
`is_blocking`	No	Filter for incomplete tasks with dependents
`is_subtask`	No	Filter for subtasks
`liked_by_not`	No	Comma-separated list of user IDs to exclude
`modified_at_after`	No	ISO 8601 datetime string
`modified_at_before`	No	ISO 8601 datetime string
`modified_on`	No	ISO 8601 date string or null
`modified_on_after`	No	ISO 8601 date string
`modified_on_before`	No	ISO 8601 date string
`opt_fields`	No	Comma-separated list of optional fields to include
`portfolios_any`	No	Comma-separated list of portfolio IDs
`projects_all`	No	Comma-separated list of project IDs that must all match
`projects_any`	No	Comma-separated list of project IDs
`projects_not`	No	Comma-separated list of project IDs to exclude
`resource_subtype`	No	Filter by task subtype (e.g. milestone)
`sections_all`	No	Comma-separated list of section IDs that must all match
`sections_any`	No	Comma-separated list of section IDs
`sections_not`	No	Comma-separated list of section IDs to exclude
`sort_ascending`	No	Sort in ascending order
`sort_by`	No	Sort by: due_date, created_at, completed_at, likes, modified_at	modified_at
`start_on`	No	ISO 8601 date string or null
`start_on_after`	No	ISO 8601 date string
`start_on_before`	No	ISO 8601 date string
`tags_all`	No	Comma-separated list of tag IDs that must all match
`tags_any`	No	Comma-separated list of tag IDs
`tags_not`	No	Comma-separated list of tag IDs to exclude
`teams_any`	No	Comma-separated list of team IDs
`text`	No	Text to search for in task names and descriptions
`workspace`	Yes	The workspace to search in

Input Schema (JSON Schema)

{
  "properties": {
    "assigned_by_any": {
      "description": "Comma-separated list of user IDs",
      "type": "string"
    },
    "assigned_by_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "assignee_any": {
      "description": "Comma-separated list of user IDs",
      "type": "string"
    },
    "assignee_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "commented_on_by_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "completed": {
      "description": "Filter for completed tasks",
      "type": "boolean"
    },
    "completed_at_after": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "completed_at_before": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "completed_on": {
      "description": "ISO 8601 date string or null",
      "type": "string"
    },
    "completed_on_after": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "completed_on_before": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "created_at_after": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "created_at_before": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "created_by_any": {
      "description": "Comma-separated list of user IDs",
      "type": "string"
    },
    "created_by_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "created_on": {
      "description": "ISO 8601 date string or null",
      "type": "string"
    },
    "created_on_after": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "created_on_before": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "custom_fields": {
      "description": "Object containing custom field filters. Keys should be in the format \"{gid}.{operation}\" where operation can be:\n- {gid}.is_set: Boolean - For all custom field types, check if value is set\n- {gid}.value: String|Number|String(enum_option_gid) - Direct value match for Text, Number or Enum fields\n- {gid}.starts_with: String - For Text fields only, check if value starts with string\n- {gid}.ends_with: String - For Text fields only, check if value ends with string\n- {gid}.contains: String - For Text fields only, check if value contains string\n- {gid}.less_than: Number - For Number fields only, check if value is less than number\n- {gid}.greater_than: Number - For Number fields only, check if value is greater than number\n\nExample: { \"12345.value\": \"high\", \"67890.contains\": \"urgent\" }",
      "type": "object"
    },
    "due_at_after": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "due_at_before": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "due_on": {
      "description": "ISO 8601 date string or null",
      "type": "string"
    },
    "due_on_after": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "due_on_before": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "followers_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "has_attachment": {
      "description": "Filter for tasks with attachments",
      "type": "boolean"
    },
    "is_blocked": {
      "description": "Filter for tasks with incomplete dependencies",
      "type": "boolean"
    },
    "is_blocking": {
      "description": "Filter for incomplete tasks with dependents",
      "type": "boolean"
    },
    "is_subtask": {
      "description": "Filter for subtasks",
      "type": "boolean"
    },
    "liked_by_not": {
      "description": "Comma-separated list of user IDs to exclude",
      "type": "string"
    },
    "modified_at_after": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "modified_at_before": {
      "description": "ISO 8601 datetime string",
      "type": "string"
    },
    "modified_on": {
      "description": "ISO 8601 date string or null",
      "type": "string"
    },
    "modified_on_after": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "modified_on_before": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "opt_fields": {
      "description": "Comma-separated list of optional fields to include",
      "type": "string"
    },
    "portfolios_any": {
      "description": "Comma-separated list of portfolio IDs",
      "type": "string"
    },
    "projects_all": {
      "description": "Comma-separated list of project IDs that must all match",
      "type": "string"
    },
    "projects_any": {
      "description": "Comma-separated list of project IDs",
      "type": "string"
    },
    "projects_not": {
      "description": "Comma-separated list of project IDs to exclude",
      "type": "string"
    },
    "resource_subtype": {
      "description": "Filter by task subtype (e.g. milestone)",
      "type": "string"
    },
    "sections_all": {
      "description": "Comma-separated list of section IDs that must all match",
      "type": "string"
    },
    "sections_any": {
      "description": "Comma-separated list of section IDs",
      "type": "string"
    },
    "sections_not": {
      "description": "Comma-separated list of section IDs to exclude",
      "type": "string"
    },
    "sort_ascending": {
      "default": false,
      "description": "Sort in ascending order",
      "type": "boolean"
    },
    "sort_by": {
      "default": "modified_at",
      "description": "Sort by: due_date, created_at, completed_at, likes, modified_at",
      "type": "string"
    },
    "start_on": {
      "description": "ISO 8601 date string or null",
      "type": "string"
    },
    "start_on_after": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "start_on_before": {
      "description": "ISO 8601 date string",
      "type": "string"
    },
    "tags_all": {
      "description": "Comma-separated list of tag IDs that must all match",
      "type": "string"
    },
    "tags_any": {
      "description": "Comma-separated list of tag IDs",
      "type": "string"
    },
    "tags_not": {
      "description": "Comma-separated list of tag IDs to exclude",
      "type": "string"
    },
    "teams_any": {
      "description": "Comma-separated list of team IDs",
      "type": "string"
    },
    "text": {
      "description": "Text to search for in task names and descriptions",
      "type": "string"
    },
    "workspace": {
      "description": "The workspace to search in",
      "type": "string"
    }
  },
  "required": [
    "workspace"
  ],
  "type": "object"
}

mcp-server-asana

asana_search_tasks

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from mcp-server-asana

Related Tools