Create tasks from emails and attach email responses to tasks using the ClickUp add-in.
What you'll need
- You can use this ClickUp add-in on every ClickUp plan.
- Guests and limited members can't use this ClickUp add-in.
- The add-in for Outlook is not available for mobile.
This integration will not work with shared or delegate mailboxes.
Compatibility
The add-in uses Microsoft's Nested App Authentication (NAA) to access message attachments. You'll need an Outlook client and mailbox that support NAA.
Check Microsoft's Nested App Authentication requirements for minimum Outlook versions. NAA isn't supported when the add-in is opened in an Outlook.com or Gmail mailbox.
Use Microsoft's guides to find your Outlook version or identify the Exchange Server version your account connects to.
Install the ClickUp add-in
Install the add-in here. If your version of Outlook requires a URL, enter: https://modern-outlook.clickup.com/manifest.xml.
You can also manually install the add-in:
- Open an email in the Outlook app.
- Select Store or Get Add-Ins from the top bar. Web users can find Get Add-Ins in the ellipsis ... menu next to the Reply and Forward buttons. Labels may vary by Outlook version.
- Search for ClickUp for Outlook in the Add-In Store.
- Click Add. By clicking Add, you agree to the add-in's license terms and privacy policy.
Admin approval
The Outlook add-in requests the delegated Microsoft Graph Mail.Read permission, not application permissions. It works with the signed-in user's own mailbox. Shared and delegate mailboxes are not supported. Whether a user can consent depends on your Microsoft Entra tenant settings. If user consent is restricted, a Microsoft admin must grant consent.
Ask a Microsoft admin to follow these steps:
- Open Microsoft Entra ID.
- Navigate to Enterprise applications.
- Search for the app using Application ID
aaedd6ae-575a-4582-ba2b-7c114a26e870. - Select the ClickUp app.
- Open Permissions under Security and review the requested Graph permission.
- Grant the required admin consent.
| Scope | Purpose |
Mail.Read |
Allows the app to read the user's mailbox. The add-in uses this permission inside Outlook to retrieve the open message's attachments from Microsoft Graph. It reads the email body through Office.js. |
The Mail.Read token permits reading the user's whole mailbox, but the add-in uses it only for the open message and its attachments.
The Office add-in manifest also requests the ReadWriteMailbox permission level, which is broader than what the add-in needs to read the selected email. This is an Office add-in permission level, not a Microsoft Graph permission.
The add-in reads the email body through Office.js and attachments through Microsoft Graph. Its Graph access uses your signed-in account, not application permissions or shared-mailbox scopes. It does not use EWS, IMAP, POP, or SMTP AUTH.
Your Microsoft Entra tenant's consent policy determines whether you can consent yourself. If user consent is restricted, a Microsoft administrator must grant the required Graph consent.
Administrators should review Graph permissions in Microsoft Entra and the Office permission level in the add-in manifest and deployment configuration. These are separate reviews.
See Microsoft's guide to managing application permissions.
The add-in's Entra application ID is aaedd6ae-575a-4582-ba2b-7c114a26e870. Its Office manifest ID, c1f0f062-29a7-4adf-bae8-a04aef9498ca, is a different identifier. Don't substitute an Outlook Mail, Calendar, or Email ClickApp registration when reviewing the add-in.
Open the ClickUp add-in
After installing the add-in, you can complete the setup by logging into your ClickUp account:
- Open an email in the Outlook app.
- In the upper-right corner, click the Apps icon.
- Select ClickUp.
- Log in to your ClickUp account.
- Select the Workspaces that should have access and click Connect Workspaces.
During Microsoft authorization, the consent screen lists the requested permissions. Your organization's consent settings determine whether you or a Microsoft admin can approve them.
Switch or add Workspaces
To see your connected Workspaces, click your avatar in the upper-left corner of the add-in.
To add a new Workspace to the add-in, click the plus icon next to Workspaces.
Create new tasks
To create a new task from the ClickUp add-in:
- Open the add-in from an email in Outlook.
- In the upper-right corner, select the New Task tab.
- Name your task, select a List for it, and add any additional details.
- In the lower-right corner, click Create New Task.
The task is created before its email files finish uploading. An upload failure can leave a task without some or all of the selected email content.
Attach emails to tasks
To attach an email to an existing task or create a new task from it:
- Open the add-in from an email in Outlook.
- To attach the email to an existing task, select Attach to task. To create a new task and attach the email to it, click + New task.
The email copy and its attachments use separate upload requests. A failed upload can leave only part of the email content attached to an existing task.
What the add-in sends to ClickUp
When you open the pane, the add-in uses the message ID to look up linked ClickUp tasks. This lookup does not upload the email body or its attachment files. The pane also makes separate requests for ClickUp account, Workspace, and task information.
The add-in reads the selected email body and attachment data inside Outlook. When you choose to create a task from the email or attach the email to a task, it uploads:
- An HTML copy of the email body.
- A thumbnail.
- Email metadata, including the message ID, subject, sender, and Outlook link.
- Supported message attachments as separate files.
These uploads become task attachments. Some Outlook attachment types may not transfer. Check the task after uploading to make sure the files you need are attached.
Data caching
The add-in holds the selected email body, metadata, and attachment data in memory while it runs. It does not save this temporary email copy to browser local storage or Office roaming settings.
ClickUp sign-in data and some preferences use browser storage and Office roaming settings. Microsoft's sign-in library keeps a separate token cache in browser storage. The Microsoft Graph token stays inside the Outlook client and isn't sent to ClickUp.
Signing out removes ClickUp sign-in data and roaming settings. It does not clear Microsoft's token cache or all email data held in memory. Closing the pane is not a data-deletion control.
Security
Email content uploaded to a task becomes saved ClickUp content. Removing the add-in or signing out does not delete those copies.
When you use supported ClickUp Brain features, saved email content may be included according to your Workspace settings and content permissions. The add-in does not continuously import your mailbox.
Review our data hosting article, ClickUp's subprocessor list, and the Data Protection Addendum for hosting and processing terms. Integration processing may take place outside your Workspace's selected hosting region.
Removing the add-in does not revoke Microsoft consent. A Microsoft administrator can review or remove the application's permissions in Microsoft Entra ID. Depending on tenant policy, users may also be able to remove their own consent through My Apps.
For more information, see the ClickUp Security Policy and Privacy and security.
Unexpected behavior
Common solutions for unexpected behavior.
Unable to connect your ClickUp account
Try signing in to ClickUp again from the add-in. Microsoft authorization is separate from ClickUp sign-in: attachment access also requires a compatible Outlook client and the required Microsoft consent.
General connection issues or blank screen
If you're experiencing connection issues or seeing a blank screen, try the Use token option for ClickUp sign-in:
- Select Use token in the add-in. If you don't see this option, remove and reinstall the add-in.
- In ClickUp, in the upper-left corner, click your Workspace avatar.
- Select Settings.
- In the All settings sidebar, click Apps.
- Click Generate under API Token.
- Click Copy.
- Go back to the add-in and paste your token to connect the two accounts.
This option signs you in to ClickUp. It does not replace Microsoft authorization for reading message attachments.
Unable to install add-ins
If you're unable to install add-ins entirely, you'll need to work with your IT team.
Team share
Currently, the add-in for Outlook only shows people who have been granted direct access or have been individually invited. If someone's access is only through a Team share, they won't appear as an assignable option in the add-in. To make them visible, invite that user directly to the List, Subfolder, or Folder you're working in.
Outlook add-in required scopes
Your Microsoft Entra tenant settings decide whether you can consent to delegated Mail.Read. If user consent is restricted, a Microsoft admin must grant consent.
Removing the add-in does not remove Microsoft consent. A Microsoft admin removes it from Enterprise applications in Microsoft Entra ID.
The Office manifest permission ReadWriteMailbox is separate from Graph Mail.Read. Review Graph consent in Entra and Office permissions in the add-in's manifest and deployment settings.
Limit who can use the add-in
Microsoft admins can control who can use the add-in:
- In Microsoft Entra ID, set Assignment required to Yes on the ClickUp enterprise application. Only assigned users and groups can sign in. Others get
AADSTS50105. Group assignment requires Entra ID P1 or P2. - In the Microsoft 365 admin center, use Centralized Deployment to deploy the add-in to specific users or groups.