Skip to main content
Version: Next

Team MCP API

The Team MCP API allows you to interact with ClickUp teams (workspaces) using the Model Context Protocol interface. For more information about MCP, see the official documentation.

Errors and retries

All MCP tools return a uniform ToolResponse envelope (ok, result, issues[]). When ok: false, inspect issues and apply retries/backoff (respect retry_after_ms for 429 and back off on 5xx/transient errors). See Errors and Retries (MCP) for details.

Available Functions​

get_authorized_teams​

  • Function name: get_authorized_teams
  • Parameters: none
  • Returns: WorkspaceListResult in ToolResponse
{
  "ok": true, // Tool succeeded
  "result": {
    "items": [
      {
        "team_id": "team_1", // Workspace (team) ID
        "name": "Engineering" // Workspace name
      }
    ]
  },
  "issues": [] // Optional warnings/issues collected during execution
}
  • Errors
    • AUTH_ERROR (401), FORBIDDEN (403)
    • RATE_LIMIT (429)
    • UPSTREAM_ERROR (5xx/timeout)