Home / Servers / Asana API / search_projects_for_workspace

Search projects in a workspace

An MCP tool from the Asana API server, hosted on mcp.hjlabs.in.

Search projects in a workspace Required scope: projects:read To mirror the functionality of the Asana web app's advanced search feature, the Asana API has a project search endpoint that allows you to build complex filters to find… [GET /workspaces/{workspace_gid}/projects/search]

Name on the gateway: asana_api__search_projects_for_workspace · read-only.

Parameters

NameTypeDescription
workspace_gid requiredstringGlobally unique identifier for the workspace or…
opt_prettybooleanProvides “pretty” output. Provides the response in a “pretty” format. In the…
limitintegerResults per search response. The number of objects to return in one search…
textstringPerforms full-text search on the project name.
sort_bydue_date | created_at | completed_at | modified_at | relevanceOne of due_date, created_at, completed_at, relevance, or modified_at, defaults…
sort_ascendingbooleanDefault false.
completedbooleanFilter on project completion status.
teams.anystringComma-separated list of team IDs.
owner.anystringComma-separated list of user identifiers to filter on as project owners. This…
members.anystringComma-separated list of user identifiers to filter on as members. This can…
members.notstringComma-separated list of user identifiers to exclude as members. This can…
portfolios.anystringComma-separated list of portfolio IDs to filter on.
completed_onstringISO 8601 date string or null.
completed_on.beforestringISO 8601 date string.
completed_on.afterstringISO 8601 date string.
completed_at.beforestringISO 8601 datetime string.
completed_at.afterstringISO 8601 datetime string.
created_onstringISO 8601 date string or null.
created_on.beforestringISO 8601 date string.
created_on.afterstringISO 8601 date string.
created_at.beforestringISO 8601 datetime string.
created_at.afterstringISO 8601 datetime string.
due_onstringISO 8601 date string or null.
due_on.beforestringISO 8601 date string.
due_on.afterstringISO 8601 date string.
due_at.beforestringISO 8601 datetime string.
due_at.afterstringISO 8601 datetime string.
start_onstringISO 8601 date string or null.
start_on.beforestringISO 8601 date string.
start_on.afterstringISO 8601 date string.
opt_fieldsarrayThis 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:

call_tool arguments
{
  "name": "asana_api__search_projects_for_workspace",
  "arguments": {
    "workspace_gid": "…"
  }
}

Or connect the Asana API server directly, which lists 270 tools including this one:

Run in your terminal
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 projects in a workspace tool with workspace_gid set to ….

More from Asana API