ClickUp MCP Server

Instructions

Implementation Reference

• src/clickup_mcp/tools.py:934-950 (handler)

  The main handler function for the 'list_spaces' tool. It fetches spaces using the ClickUp client and returns a formatted list.
  async def list_spaces(self) -> Dict[str, Any]: """List all spaces.""" spaces = await self.client.get_spaces() return { "spaces": [ { "id": space.id, "name": space.name, "private": space.private, "color": space.color, } for space in spaces ], "count": len(spaces), }
• src/clickup_mcp/tools.py:289-296 (schema)

  The input schema and metadata definition for the 'list_spaces' tool, part of get_tool_definitions().
  Tool( name="list_spaces", description="List all spaces in workspace", inputSchema={ "type": "object", "properties": {}, }, ),
• src/clickup_mcp/tools.py:23-57 (registration)

  Registration of the 'list_spaces' handler in the ClickUpTools class's _tools dictionary during __init__.
  self._tools: Dict[str, Callable] = { "create_task": self.create_task, "get_task": self.get_task, "update_task": self.update_task, "delete_task": self.delete_task, "list_tasks": self.list_tasks, "search_tasks": self.search_tasks, "get_subtasks": self.get_subtasks, "get_task_comments": self.get_task_comments, "create_task_comment": self.create_task_comment, "get_task_status": self.get_task_status, "update_task_status": self.update_task_status, "get_assignees": self.get_assignees, "assign_task": self.assign_task, "list_spaces": self.list_spaces, "list_folders": self.list_folders, "list_lists": self.list_lists, "find_list_by_name": self.find_list_by_name, # Bulk operations "bulk_update_tasks": self.bulk_update_tasks, "bulk_move_tasks": self.bulk_move_tasks, # Time tracking "get_time_tracked": self.get_time_tracked, "log_time": self.log_time, # Templates "create_task_from_template": self.create_task_from_template, "create_task_chain": self.create_task_chain, # Analytics "get_team_workload": self.get_team_workload, "get_task_analytics": self.get_task_analytics, # User management "list_users": self.list_users, "get_current_user": self.get_current_user, "find_user_by_name": self.find_user_by_name, }
• src/clickup_mcp/server.py:41-44 (registration)

  MCP server registration of tools list handler, which exposes 'list_spaces' via ClickUpTools.get_tool_definitions().
  @self.server.list_tools() async def list_tools() -> List[Tool]: """List all available tools.""" return self.tools.get_tool_definitions()