> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stagewhisper.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Connect ClickUp so your insights can use what your team tracks there, and see what StageWhisper found in the Playbook tab during the call.

If your team keeps its work in ClickUp, StageWhisper can check it while you talk. When the call turns to a deal or a deadline your team tracks there, StageWhisper looks it up and uses what it finds in your insights. An insight that relies on a task ends with the task's name. Click the name to open the task in ClickUp. Everything StageWhisper finds also shows up in the **Playbook** tab, so you can open it yourself.

ClickUp comes with Signals. StageWhisper only reads from ClickUp. It never creates, changes or deletes anything there.

## Connect ClickUp

1. Click the cog on the control bar to open **Settings**, then choose **Integrations**.
2. Click **Connect ClickUp** on the ClickUp card. ClickUp opens in your browser.
3. Sign in to ClickUp and allow access. If ClickUp asks which Workspace to share, pick the one where your team keeps its tasks.
4. Switch back to StageWhisper. The card now says **Connected**, with a refresh button next to **Disconnect**.

Until you finish in the browser, the card says **Finish signing in to ClickUp in your browser**.

## During a call

Start your call the usual way. Once you're past the greetings, StageWhisper looks up what your team has on the topic of the call. After that, it checks again whenever a task, person, customer, project or date comes up that it hasn't looked up yet. If ClickUp might already have the answer, such as who's involved or where a task stands, StageWhisper looks it up before it suggests you ask. Each lookup checks ClickUp and the files attached to your playbook together.

For each task a lookup finds, StageWhisper reads much more than the search result: the status, who it's assigned to, the due date, the full description, its recent comments and the replies under the latest ones. For a doc, it reads its pages. For a file, it notes the name and the type. When a task links to a doc in its description or comments, StageWhisper reads that doc too, so later lookups can use it.

On a task with a long discussion, StageWhisper puts the newest comments and replies first. So a reply from yesterday still reaches your insights, even when someone pasted a long meeting note into the same task last month.

StageWhisper keeps an index of your ClickUp workspace on your computer. It covers the lists and docs your team worked on in the last 90 days, plus the docs that tasks in those lists link to. So if someone shared a few tasks with you, the meeting notes those tasks point to are in your index too, as long as ClickUp lets you open them. A linked doc stays in the index while a task there still links to it. StageWhisper builds the index once, right after you connect. If you quit before it's done, it carries on the next time you open the app. During a call it leaves ClickUp to your lookups, so they don't wait behind the index, and it picks up where it stopped once the call ends. After that first build, StageWhisper only checks ClickUp for changes when you click the refresh button. Everything a lookup reads goes into the same index, and every lookup searches it along with the files attached to your playbook. That way StageWhisper can find a decision buried in a long meeting note, even when the words of the question never appear in the task's name. When the call turns to who handles the setup, it can find the line in last week's notes that names the owner. An insight then uses the passages that fit best, each labeled with where it came from, such as a comment by Ana on 15 Oct. So instead of a general tip, an insight can tell you the renewal is due on October 20 and that Ana owns it.

A lookup only uses passages with real content. A card with nothing but a name and a few facts, such as a task's status and due date or a file's name, never takes a passage's place, and neither does a one-line reply like "works". For an item like that, StageWhisper sends one short line instead, with its name and link, the list or folder it's in, and its status, owner and due date when ClickUp has them. So an insight can still tell you who owns a task and when it's due. You'll still see the item in the **Playbook** tab. When the same text sits in two places, such as notes pasted into both a doc and a comment, StageWhisper uses it once.

Reading takes a few seconds and happens in the background. A lookup waits up to about three seconds for it. If the reading isn't done by then, the lookup goes ahead with what StageWhisper has read so far, plus that short line for each item it hasn't read yet. Later lookups use everything it has read. When a new question comes up while ClickUp is still answering, StageWhisper answers it straight away from the index. It picks the passages that fit by comparing them with what was said on the call, along with the search phrase.

If nothing in ClickUp matches the whole search, StageWhisper tries the words one at a time. That helps when your workspace is in a different language from the call.

If ClickUp asks StageWhisper to slow down, StageWhisper waits as long as ClickUp asks and answers from the index in the meantime. Some ClickUp plans also cap how many requests ClickUp answers in a day, and building or refreshing the index counts toward that cap. Once StageWhisper reaches it, it stops asking ClickUp until the time ClickUp gives, even if you restart the app, and keeps answering from the index. If ClickUp is slow to answer, the call goes on without it, and StageWhisper can try that lookup again a little later. Items a lookup read from outside those lists and docs, and the docs those items link to, stay in the index until your next call starts.

## Refresh

Click the refresh button on the ClickUp card to bring in what changed in ClickUp since the last refresh. A ring around the button fills up as StageWhisper reads. You can't refresh during a call. The button is dimmed until the call ends.

If ClickUp asks StageWhisper to wait, the ring turns amber and empties as the wait runs out. Hover over the button to see the exact time it's ready again. If a refresh was under way, StageWhisper finishes it by itself after the wait, so you don't need to click again.

If StageWhisper has to stop before it can bring in your workspace, for example because ClickUp shared no lists or docs with you, the refresh button turns amber with a full ring around it. Click it to try again. During a call it stays dimmed until the call ends. If ClickUp signed you out, the card asks you to [reconnect](#reconnect) instead.

## See what StageWhisper found

Open the **Playbook** tab during a call. As soon as StageWhisper finds something, a **From your ClickUp** list appears below your playbook. The newest finds sit at the top.

Each row shows:

* The name of the task, doc or file, with an icon for its kind.
* The status, with a dot in the color your team uses for it in ClickUp.
* Who owns it.
* The due date. It turns red once the date has passed and amber when it's two days away or less. Items that are already done stay gray.
* The list or folder it lives in.

Click a row to open it in ClickUp in your browser. While StageWhisper is still checking ClickUp, a light runs along the line under the list's title.

The list keeps the 20 most recent finds. It stays after the call ends, so you can follow up on what came up, and it clears when you start your next call. StageWhisper never saves it, so it's gone once you quit the app.

## What leaves your computer

Lookups run on your computer and go straight to ClickUp. To search, StageWhisper sends ClickUp a short search phrase based on the conversation, and sometimes the words of that phrase one by one. To read what it found, it asks ClickUp for those items and their comments. To build and refresh its index, it asks ClickUp for your workspace's lists and docs, the tasks in them and the docs those tasks link to. Your ClickUp sign-in stays in your computer's credential store and never reaches StageWhisper's servers.

What StageWhisper reads from ClickUp stays on your computer, in an encrypted index. Disconnecting ClickUp deletes it.

Each lookup sends a few short passages from those tasks, comments, docs and files, each with the name of the item it came from. For an item it found but has no passage from, it sends one line instead: the item's name and link, the list or folder it's in, and its status, owner and due date if it has them. They go to StageWhisper's servers and our AI provider so your insights can use them. Before a passage leaves your computer, StageWhisper replaces each link in it with the name of the site it points to and removes anything that looks like a password, access token or key. This happens before StageWhisper indexes what it read, so what it removes never reaches StageWhisper's servers or our AI provider. The link to the ClickUp item itself still goes along, so an insight can point you to it. StageWhisper's servers hold them in memory during the call and never save them. When an insight relies on a task, the task's name and link are saved with that insight, so you can still see them in your Library after the call.

If your connection drops during a call, your computer sends the passages from that call again when it reconnects, so your insights can still use them. They are held in memory the same way and go no further.

## Reconnect

If the card says **ClickUp signed you out**, your ClickUp access ran out or was removed. Click **Reconnect** and sign in again. Until you do, your calls go on without ClickUp.

If you pick a different Workspace when you sign in again, StageWhisper deletes the index of the one you left and builds a new one. Pick the same Workspace and StageWhisper keeps your index. Either way, your insights use only what the account you signed in with can open in ClickUp.

## Disconnect

Click **Disconnect** on the ClickUp card. StageWhisper deletes its ClickUp sign-in and its ClickUp index from your computer and stops checking ClickUp during your calls.

## Don't see the ClickUp card?

The card only shows up for Signals subscribers. ClickUp is also rolling out in stages, so you may not see the card yet even with Signals.

If the card says **Connected** but your insights never mention a task, look in the **Playbook** tab first. It shows what StageWhisper found even when no insight used it. If the list never appears, check that insights are on. StageWhisper only looks things up while it's showing you insights. It waits until the call is past the greetings before its first lookup, so a very short call can end before it searches.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.