Home / Servers / Asana API / search_records_for_workspace

Search records in a workspace

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

Search records in a workspace Required scope: records:read To mirror the functionality of the Asana web app's advanced search feature, this endpoint allows you to build complex filters to find and retrieve records across all of… [GET /workspaces/{workspace_gid}/records/search]

Name on the gateway: asana_api__search_records_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 page. The number of objects to return per page. The value must be…
textstringPerforms full-text search on the record name
teams.anystringComma-separated list of team IDs
followers.anystringComma-separated list of user identifiers. This can either be the string "me"…
followers.notstringComma-separated list of user identifiers. This can either be the string "me"…
tables.anystringComma-separated list of table IDs
tables.notstringComma-separated list of table IDs
tables.allstringComma-separated list of table IDs
created_on.beforestringISO 8601 date string
created_on.afterstringISO 8601 date string
created_onstringISO 8601 date string or null
created_at.beforestringISO 8601 datetime string
created_at.afterstringISO 8601 datetime string
sort_bycreated_at | modified_atOne of created_at or modified_at, defaults to modified_at
sort_ascendingbooleanDefault false
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_records_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 records in a workspace tool with workspace_gid set to ….

More from Asana API