> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocoya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ocoya_list_workspaces

> List or search workspaces allowed by the MCP OAuth grant.

# `ocoya_list_workspaces`

Lists or searches workspaces allowed by the MCP OAuth grant. Use this first when you need a `workspaceId` for workspace-scoped tools.

## Arguments

| Name    | Type   | Required | Description                                      |
| ------- | ------ | -------- | ------------------------------------------------ |
| `query` | string | No       | Optional case-insensitive workspace name search. |

## Example

```json theme={null}
{
  "name": "ocoya_list_workspaces",
  "arguments": {
    "query": "main"
  }
}
```

## Returns

Returns authorized workspaces with IDs, names, images, timezone, color theme, and user count.