clickup_create_board
Create a new board view in a ClickUp space.
LABSCO SUMMARY
It reaches most of a ClickUp workspace rather than only the task list — the Docs and custom-field tools are what set it apart.
A Personal API Token is the whole auth story, so the server acts as you and sees exactly what you see. One rough edge is flagged in the server itself: clickup_update_view runs into known issues on ClickUp's own v2 view endpoint, so if a view edit errors out, recreate the view instead of retrying.
What it is
An MCP server over the ClickUp API, authenticated with your own Personal API Token and run over stdio, exposing the workspace hierarchy as well as tasks.
What you get
- Tasks created and updated with status, priority, assignees, tags, due date, description and time estimate
- The workspace tree: teams listed; spaces and folders created, read, updated and deleted; lists created and listed
- Custom fields: list what is available on a list, then set or remove a value on a task
- Docs: search them across a workspace, create one, list its pages, read a page as Markdown, and edit page content or title
- Views: create list, board, calendar or gantt views on a team, space, folder or list, read a view's details, and pull the tasks inside it
- Board views created directly in a space
Requirements
A ClickUp Personal API Token, generated under My Settings > Apps and supplied as CLICKUP_PERSONAL_TOKEN. That is the only required variable — LOG_LEVEL is optional, and PORT is not used in the default stdio mode. Launch it with npx @nazruden/clickup-server.
Setup effort
One command plus a key — npx @nazruden/clickup-server, then supply credentials
USE CASES
01
Filing a task while you are still talking about it
Find the list it belongs in, then create the task with status, assignees and a due date already set.
02
Setting a custom field the API only knows by ID
List the custom fields available on the list, then write the value onto the task.
03
Editing a spec that lives in ClickUp Docs
Search the workspace for the Doc, list its pages, read the Markdown, then write the change back.
04
Standing up the structure for a new project
Create the space, add a folder inside it, then create the lists the work will live in.
05
Pulling the tasks behind a saved view
Find the views on a space or list, then read the tasks that view returns, page by page.
31 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
clickup_create_doc
Creates a new Doc within a Workspace.
clickup_create_doc_page
Creates a new page within a specific Doc.
clickup_create_folder
Creates a new Folder within a Space.
clickup_create_list
Creates a new List within a Folder or Space.
clickup_create_space
Creates a new Space within a Workspace.
clickup_create_task
Create a new task in ClickUp workspace
clickup_create_view
Creates a new View within a Team, Space, Folder, or List.
clickup_delete_folder
Deletes a Folder.
clickup_delete_space
Deletes a Space.
clickup_delete_view
Deletes a View.
clickup_edit_doc_page_content
Updates the content and/or title of a specific Doc page.
clickup_get_custom_fields
Retrieves all accessible Custom Fields for a given List.
clickup_get_doc_page_content
Retrieves the content (Markdown) of a specific Doc page.
clickup_get_doc_pages
Retrieves the list of pages within a specific Doc.
clickup_get_folder
Retrieves details for a specific Folder.
clickup_get_folders
Retrieves all Folders within a given Space.
clickup_get_lists
Get all lists in a specific folder.
clickup_get_space
Retrieves details for a specific Space.
clickup_get_spaces
Retrieves all Spaces for a given Workspace (Team).
clickup_get_teams
Get all teams (workspaces) accessible to the authenticated user.
clickup_get_view_details
Retrieves details for a specific View.
clickup_get_view_tasks
Retrieves tasks belonging to a specific View.
clickup_get_views
Retrieves all Views for a given parent (Team, Space, Folder, or List).
clickup_remove_task_custom_field_value
Removes the value of a Custom Field from a specific task.
clickup_search_docs
Searches for Docs within a Workspace (Team).
clickup_set_task_custom_field_value
Sets the value of a Custom Field on a specific task.
clickup_update_folder
Updates an existing Folder.
clickup_update_space
Updates an existing Space.
clickup_update_task
Update an existing task in ClickUp
clickup_update_view
Updates an existing View. Note: ClickUp API v2 /view/{view_id} PUT endpoint currently has known issues (Internal Server Error).
BEFORE YOU INSTALL
What to know first
Tools you get
31 tools when we connected. clickup_create_list is available but undocumented. There is no clickup_get_task: tasks are read back only through clickup_get_view_tasks, and nothing deletes tasks, lists or docs.
Requires
- npx on PATH
- CLICKUP_PERSONAL_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 31 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @nazruden/clickup-serverMCP Clients
Any MCP client — npx
ANY MCP CLIENT — NPX · JSON
{
"mcpServers": {
"clickup": {
"command": "npx",
"args": [
"@nazruden/clickup-server"
],
"env": {
"CLICKUP_PERSONAL_TOKEN": "<YOUR_CLICKUP_PERSONAL_TOKEN>"
}
}
}
}
