ClickUp MCP Server

Instructions

Implementation Reference

• src/clickup_mcp/tools.py:1352-1369 (handler)

  The core execution logic for the 'list_users' tool. Fetches workspace members from ClickUp API via client and returns formatted list.

  async def list_users(self, workspace_id: Optional[str] = None) -> Dict[str, Any]:
      """List all users in the workspace."""
      members = await self.client.get_workspace_members(workspace_id)
  
      return {
          "users": [
              {
                  "id": member.get("id"),
                  "username": member.get("username"),
                  "email": member.get("email"),
                  "initials": member.get("initials"),
                  "color": member.get("color"),
                  "profilePicture": member.get("profilePicture"),
              }
              for member in members
          ],
          "count": len(members),
      }

• src/clickup_mcp/tools.py:469-481 (schema)

  MCP Tool schema definition for 'list_users', specifying input parameters and description.

  Tool(
      name="list_users",
      description="List all users in the workspace",
      inputSchema={
          "type": "object",
          "properties": {
              "workspace_id": {
                  "type": "string",
                  "description": "Workspace ID (optional, uses default if not provided)",
              },
          },
      },
  ),

• src/clickup_mcp/tools.py:53-58 (registration)

  Registers the list_users method in the ClickUpTools class's internal tools dictionary for dynamic dispatching.

      # User management
      "list_users": self.list_users,
      "get_current_user": self.get_current_user,
      "find_user_by_name": self.find_user_by_name,
  }