Skip to main content
Version: Next

Space MCP API

The Space MCP API allows you to manage spaces within your ClickUp teams using the Model Context Protocol interface. For more information about MCP, see the official documentation.

Available Functions​

get_space​

  • Function name: get_space
  • Function parameters: {"space_id": "string"}
  • Function description: Get a ClickUp space by its ID. This function retrieves a space from ClickUp by its space ID and returns the space domain model if found, or None if the space does not exist.

Response Example​

{
  "space_id": "12345",
  "name": "Product Development",
  "color": "#00b8d9",
  "private": false,
  "avatar": "https://example.com/avatar.png",
  "statuses": [
    {
      "status_id": "status123",
      "status": "In Progress",
      "color": "#4bade8",
      "type": "custom"
    }
  ],
  "multiple_assignees": true,
  "features": {
    "due_dates": {
      "enabled": true,
      "start_date": true,
      "remap_due_dates": true,
      "remap_closed_due_date": true
    },
    "time_tracking": {
      "enabled": true
    },
    "points": {
      "enabled": false
    }
  }
}

Error Handling​

This function may raise errors in the following situations:

  • Empty space ID
  • Missing or invalid API token
  • Network connectivity issues
  • API rate limiting
  • Server-side errors

Error responses will include a descriptive message:

{
  "error": "Error retrieving space: Space ID is required"
}

or

{
  "error": "Error retrieving space: Not found"
}