Home / Servers / Asana API / search_tasks_for_workspace
Search tasks in a workspace
An MCP tool from the Asana API server, hosted on mcp.hjlabs.in.
Search tasks in a workspace Required scope: tasks:read To mirror the functionality of the Asana web app's advanced search feature, the Asana API has a task search endpoint that allows you to build complex filters to find and… [GET /workspaces/{workspace_gid}/tasks/search]
Name on the gateway: asana_api__search_tasks_for_workspace · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
workspace_gid required | string | Globally unique identifier for the workspace or… |
opt_pretty | boolean | Provides “pretty” output. Provides the response in a “pretty” format. In the… |
limit | integer | Results per search response. The number of objects to return in one search… |
text | string | Performs full-text search on both task name and description |
resource_subtype | default_task | milestone | approval | custom | Filters results by the task's resource_subtype |
assignee.any | string | Comma-separated list of user identifiers. This can either be the string "me"… |
assignee.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
portfolios.any | string | Comma-separated list of portfolio IDs |
projects.any | string | Comma-separated list of project IDs. Returns tasks that are directly in these… |
projects.not | string | Comma-separated list of project IDs |
projects.all | string | Comma-separated list of project IDs |
sections.any | string | Comma-separated list of section or column IDs |
sections.not | string | Comma-separated list of section or column IDs |
sections.all | string | Comma-separated list of section or column IDs |
tags.any | string | Comma-separated list of tag IDs |
tags.not | string | Comma-separated list of tag IDs |
tags.all | string | Comma-separated list of tag IDs |
teams.any | string | Comma-separated list of team IDs |
followers.any | string | Comma-separated list of user identifiers. This can either be the string "me"… |
followers.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
created_by.any | string | Comma-separated list of user identifiers. This can either be the string "me"… |
created_by.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
assigned_by.any | string | Comma-separated list of user identifiers. This can either be the string "me"… |
assigned_by.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
liked_by.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
commented_on_by.not | string | Comma-separated list of user identifiers. This can either be the string "me"… |
due_on.before | string | ISO 8601 date string |
due_on.after | string | ISO 8601 date string |
due_on | string | ISO 8601 date string or null |
due_at.before | string | ISO 8601 datetime string |
due_at.after | string | ISO 8601 datetime string |
start_on.before | string | ISO 8601 date string |
start_on.after | string | ISO 8601 date string |
start_on | string | ISO 8601 date string or null |
created_on.before | string | ISO 8601 date string |
created_on.after | string | ISO 8601 date string |
created_on | string | ISO 8601 date string or null |
created_at.before | string | ISO 8601 datetime string |
created_at.after | string | ISO 8601 datetime string |
completed_on.before | string | ISO 8601 date string |
completed_on.after | string | ISO 8601 date string |
completed_on | string | ISO 8601 date string or null |
completed_at.before | string | ISO 8601 datetime string |
completed_at.after | string | ISO 8601 datetime string |
modified_on.before | string | ISO 8601 date string |
modified_on.after | string | ISO 8601 date string |
modified_on | string | ISO 8601 date string or null |
modified_at.before | string | ISO 8601 datetime string |
modified_at.after | string | ISO 8601 datetime string |
is_blocking | boolean | Filter to incomplete tasks with dependents |
is_blocked | boolean | Filter to tasks with incomplete dependencies |
has_attachment | boolean | Filter to tasks with attachments |
completed | boolean | Filter to completed tasks |
is_subtask | boolean | Filter to subtasks |
sort_by | due_date | created_at | completed_at | likes | modified_at | relevance | One of due_date, created_at, completed_at, likes, relevance, or modified_at… |
sort_ascending | boolean | Default false |
opt_fields | array | This endpoint returns a resource which excludes some properties by default. To… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "asana_api__search_tasks_for_workspace",
"arguments": {
"workspace_gid": "…"
}
}Or connect the Asana API server directly, which lists 270 tools including this one:
claude mcp add --transport http hj-asana-api https://mcp.hjlabs.in/mcp/asana-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the search tasks in a workspace tool with workspace_gid set to ….