ClickUp
Sync ClickUp tasks and docs into your Naumu graph, with two-way write-back.
ClickUp tracks your team's work as tasks. Connect a ClickUp workspace to a Naumu space, and Naumu pulls those tasks — and your ClickUp Docs — in as nodes (the items in your graph).
Each task's fields become node attributes (its properties, like priority or status), and the relationships between tasks, the Lists and Folders that hold them, and the people they're assigned to become edges (the connections between nodes). The work your team tracks in ClickUp becomes part of the same graph you can ask questions of.
The connection works in three steps:
- An admin connects over OAuth (no password shared).
- You pick which Spaces to bring in, and Naumu does a one-time import of those Spaces' tasks and your docs.
- From then on, Naumu keeps the graph in sync as work changes on the ClickUp side — and writes your Naumu edits back to ClickUp.
Connect a ClickUp workspace
Connecting is an admin task, and you do it entirely from inside Naumu — no command line, API key, or external setup required.
- Open the space you want to populate.
- Go to Settings → Integrations.
- In the ClickUp card, select Connect.
- You are redirected to authorize Naumu. Approve the requested access.
- You are returned to Naumu, which opens the space picker so you can choose what to import.
A few things to know before you start:
- You must be an owner or admin of the space. Naumu checks this before the redirect, so a connection is only ever bound to a space you can administer.
- A space connects to one ClickUp workspace at a time. If your account can reach more than one workspace, you'll be asked to pick which one this space syncs with before you choose what to import.
A ClickUp workspace can be connected to only one Naumu space at a time. If the workspace is already connected to another Naumu space, disconnect it there first.
Choose which spaces to sync
Once you've connected (and picked a workspace, if your account reaches more than one), Naumu shows you a checklist of the workspace's Spaces and asks which ones to bring in. By default every Space is pre-checked; you can clear the ones you don't want, but at least one Space has to stay selected — you can't confirm an empty selection.
There's no separate import-versus-sync toggle: selecting a Space imports it once, the first time you select it, then keeps it in sync.
You can change the scope later. While connected, a Manage spaces control reopens the same picker:
- Deselecting a Space stops its sync, but leaves the nodes it already imported in your graph.
- Re-selecting a Space resumes its sync without re-importing.
- A Space created in ClickUp after you connect appears unchecked; selecting it triggers a one-time import for just that Space.
How tasks become nodes
After you choose your Spaces, Naumu fetches their Folders, Lists, tasks, members, tags, and statuses, then proposes how to fit them into the space's schema — the set of node types your graph already uses. Each kind of source item becomes its own Naumu node type:
- Tasks. Each ClickUp task type becomes its own node type, including custom task types like Bug, Feature, or Milestone.
- Spaces, Folders, and Lists become their own container types, so tasks can be grouped under them.
- Members become nodes that tasks are assigned to.
The proposal is additive: it never removes or rewrites types you already have, and a proposed type that matches one in your schema by name reuses the existing type rather than duplicating it.
Field mapping
Rather than copying every field word for word, Naumu maps the fields it imports onto a small, consistent set of node attributes and edges. Here's where each field lands:
| Source field | Where it lands in Naumu |
|---|---|
| Task title | Node label |
| Task description | The node's content |
| ClickUp task URL | A Url attribute |
| Priority | A Priority select attribute |
| Status / workflow state | A Status select attribute |
| Tags | A Tags multi-select attribute |
| Due date and start date | Date attributes |
| Space / Folder / List, assignee, parent task | Edges to the related nodes |
Tags are free-form, so Naumu adds new tag values to the schema as it encounters them rather than locking in a fixed list up front.
Docs become notes
ClickUp Docs come in too. After the task import, Naumu imports your Docs once, turning each one into a native Naumu Note you can read and edit like any other note.
Naumu then reads those notes and extracts typed nodes and edges from the prose — for example, the requirements or decisions described in a spec. It dedupes these against the tasks and Lists it already imported.
Docs are a one-time pull. ClickUp doesn't send events when a doc changes, so docs aren't re-synced. Tasks keep syncing.
Tracking status and staying in sync
The connection doesn't stop at the first import. As tasks change in ClickUp — a status moves, a new task is created, an assignment changes — Naumu updates the matching nodes in near real time. As a backstop, a daily reconciliation pass double-checks everything, so nothing drifts out of sync if a live update is ever missed. Only tasks in the Spaces you selected sync; changes outside that scope are ignored.
For ClickUp, the sync also runs the other way: edits you make in Naumu to a task that came from ClickUp — its title, description, status, priority, due date, start date, assignees, or tags — are written back to ClickUp. This applies only to tasks that came from ClickUp.
Disconnecting
Disconnect from the same Settings → Integrations panel. Disconnecting is a soft operation: it clears the access tokens and stops syncing, but the nodes you've already imported stay in your graph. If you reconnect the same workspace later, Naumu resumes syncing against those existing nodes rather than creating duplicates.
Related
- Jira — sync issues from Jira, with two-way write-back.
- Linear — sync issues from Linear the same way.
- Spaces — the space a ClickUp workspace connects to.
- Schema — the node types and attributes imported tasks map onto.
- Views — filter imported tasks by status, priority, or assignee.
- Notes — where your imported ClickUp Docs land.
- Ask Naumu — question your synced tasks in plain language.