Use this tool to get a structural overview of a workspace's contents. It returns up to 100 boards, 100 docs, and 100 folders, organized by folder membership. Root-level items (not inside any folder) are returned separately under root_items. This is useful for understanding a workspace's layout before moving objects, creating folders, or targeting specific boards.

🚧

If any object type (boards, docs, or folders) returns exactly 100 results, assume there are additional items of that type not included in the response. Use the GraphQL API directly to paginate through the full list.

Parameters

Example

Get the full structure of workspace 12406666:

{
  "workspace_id": 12406666
}

The response includes workspace metadata, a folders array (each with its nested boards and docs), and a root_items object for boards and docs that aren't inside any folder. For example:

{
  "workspace": {
    "id": "12406666",
    "name": "MCP TEST WORKSPACE",
    "kind": "open",
    "state": "active"
  },
  "folders": [
    {
      "id": "19028717",
      "name": "Real estate agency management",
      "boards": [
        { "id": "18392419211", "name": "Agent task management Board" }
      ],
      "docs": []
    }
  ],
  "root_items": {
    "boards": [
      { "id": "18394522211", "name": "Final Asset Library" }
    ],
    "docs": [
      { "id": "35809248", "name": "test doc" }
    ]
  }
}

Programmatic equivalent

Use the GraphQL API to achieve the same result:

query {
  workspaces(ids: [12406666]) {
    id
    name
    kind
    state
    boards {
      id
      name
      folder_id
    }
    folders {
      id
      name
      children {
        id
        name
      }
    }
  }
}

For full documentation, see Workspaces.