Use this tool to retrieve the workspaces accessible to the current user. This is typically the first step in any workspace-oriented workflow—you'll need the workspace ID to create folders, retrieve workspace contents, or move objects. The tool supports pagination and optional text filtering.

Note: Results are limited to 100 workspaces per page. If your account has more than 100 workspaces, use the page parameter to paginate through the full list. The searchTerm filter only supports alphanumeric characters.

Parameters

Parameter	Type	Required	Description
searchTerm	`string`	No	Filters results to workspaces whose name matches the search term. Only alphanumeric characters are supported.
limit	`number`	No	Number of workspaces to return per page. Min: `1`, max: `100`, default: `100`. Use a lower value for smaller responses.
page	`number`	No	Page number to return. Default: `1`. Increment to paginate through large workspace lists.

Example

List the first 20 workspaces:

{
  "limit": 20
}

The response includes each workspace's id, name, description (if set), and url. For example, workspace 12406666 returned:

{
  "id": "12406666",
  "name": "MCP TEST WORKSPACE",
  "description": "Workspace for demonstrating MCP tools and agent capabilities",
  "url": "https://monday.monday.com/workspaces/12406666"
}

The response also includes a next_page field indicating the next page number when more results are available.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

query {
  workspaces(limit: 20, page: 1) {
    id
    name
    description
    kind
    state
  }
}

For full documentation, see Workspaces.