ClickUp MCP: hierarchy, custom fields, and setup

    The hierarchy is what breaks ClickUp MCP setups. Here is how to scope it so it works.

    UnconfirmedLast checked: September 2026

    We could not confirm a first-party ClickUp MCP server when we last checked. Community servers built on the ClickUp API exist, and the connector platforms list ClickUp.

    What it can do

    • Walk the space, folder and list hierarchy
    • Create and update tasks, including assignees and due dates
    • Read and write custom fields where the server implements them
    • Comment on tasks

    What it can't do

    • The hierarchy is deep, so an unscoped request burns tool calls walking it before doing anything
    • Custom field support varies per server; many implement reads and not writes
    • ClickUp rate limits are per token and easy to hit with bulk edits

    ClickUp's depth is its selling point in the app and its main problem over MCP. Workspace, space, folder, list, task, subtask: to act on one task an assistant may need several calls just to find it. Every setup that feels slow is a scoping problem, not a performance problem.

    Scope first, then ask

    Give the assistant the list you mean. "In the Marketing space, Q4 folder, Launch list" turns a tree walk into a single lookup. If you work mostly in two or three lists, keep their IDs somewhere you can paste; it changes the experience completely.

    Custom fields are the honest weak spot

    Teams that use ClickUp seriously live in custom fields, and community MCP servers implement them unevenly. Plenty can read a custom field and cannot write one. Before building any routine on top of this, test the exact write you care about — do not infer support from the README.

    What it is good at

    Intake and triage. A paragraph becomes a correctly placed task with an assignee and a due date. Cleanup, too: finding tasks with no assignee or no due date across one list is a question ClickUp's own filters answer, but it is faster to ask, and the assistant can fix them in the same breath.

    Where LemTask stands today

    LemTask does not ship an MCP server yet, and we are not going to pretend otherwise on a page developers will read. What LemTask has working right now is outbound and inbound webhooks, Zapier, Make and Apple Shortcuts, which covers "when a task is created, do X" and "create a task from anything that can send an HTTP request". An MCP connection is on the roadmap; when it ships and we have tested it end to end with Claude, this page will say so with the config block, and not a day earlier.

    Setup, step by step

    1. 1

      Generate a personal API token

      Create a token in your ClickUp settings under Apps. It carries your own permissions, so it only sees the spaces you can see.

    2. 2

      Add a maintained server to your config

      Pick a community server with recent activity, add it to your MCP client config with the token as an environment variable, and restart the client.

    3. 3

      Note the IDs of your working lists

      Ask the assistant to list your spaces and lists once, then keep the two or three list IDs you use daily. Naming them removes the hierarchy walk.

    4. 4

      Test the exact custom field write you need

      If your workflow depends on custom fields, confirm a write succeeds before building anything on it. Read support does not imply write support.

    Questions

    Related pages

    Want a task app that automates today?

    LemTask has no MCP server yet. It does have webhooks, Zapier, Make and Apple Shortcuts working now, plus tasks, habits, a focus timer and calendar sync. Free forever for individuals.