Connect Asana to Notion

Workers run your sync on Notion’s servers. To set up your replacement, @-mention your existing synced database in a chat with Notion AI and include the Asana sync skill.

Have these ready:

• Your existing Asana synced database in Notion. Make sure Notion AI can access it.

• The complete list of Asana projects to include. Project links are a useful starting point; Notion AI may ask you to confirm their numeric project IDs.

  https://app.asana.com/1/<workspace>/project/1206617296084787/list/...

• An Asana account with access to every selected project and permission to create a personal access token.

• Access to Workers and the tools Notion AI needs to create and deploy a Worker in your workspace.

• The Asana Guide: Projects & Tasks Worker Sync.

• The Notion Workers syncs guide, for background on sync schedules, sync modes, and rate limits. This guide creates new Projects and Tasks databases. Your existing database stays available while you check the replacement. Its page links, views, relations, and Notion-only information don’t automatically transfer to the new databases.

Open a chat with Notion AI in the workspace that contains your existing synced database.

Copy the prompt below. Replace @Existing Asana sync database by typing @ and selecting the actual database from the mention menu. If you’re replacing several synced databases, mention each one.

The @-mention gives Notion AI a specific database to inspect. A typed database name alone isn’t a link to that database.

Confirm the full project list when Notion AI asks. Records visible in a filtered Notion view may represent only part of your existing sync.

Follow Notion AI’s instructions to create an Asana personal access token in Asana’s Developer Console and provide it through the secure credential input.

Don’t paste the token into the chat, a Notion page, or a database property. The Worker uses the credential to read the selected projects and tasks.

This setup uses a new Worker credential. Your existing Asana connection doesn’t automatically supply it.

If Notion AI can’t access the skill or the Worker tools, resolve that access first. The linked guide also contains setup instructions for someone on your team who can use the Notion CLI.

The skill creates two related databases:

The Tasks database includes views by project and section, a board, a timeline, a calendar, and a task dashboard. The Projects database includes a table of project details.

Check the details that matter to your existing workflow:

• Completed tasks: Both completed and incomplete tasks should be included.

• Tasks in multiple projects: A task should have one row, with relations to its selected projects.

• People: Owners and assignees can resolve to Notion members or guests by email. Owner name and Assignee name provide text when a person can’t be matched.

• Sections: The guide uses a fixed set of section options and maps other names to Other. Ask Notion AI to adapt the mapping if your current workflow uses different sections.

• Notes: The guide limits synced notes to 2,000 characters.

• Additional data: The guide doesn’t include comments, attachments, or arbitrary Asana custom fields. If you rely on them, have Notion AI assess what can be added before switching.

The guide records a parent task’s name as text. Don’t assume that all nested subtasks or parent-child relations are reproduced; compare the replacement with the tasks you need from your selected projects.

Wait until Notion AI confirms that both syncs are healthy and that the initial import is complete.

1. Compare the selected projects and a sample of tasks with Asana. Check completed tasks, dates, assignees, and project relations.

2. Check that a recent change in Asana reaches the replacement after a successful refresh.

3. Review the old database’s custom properties and Notion-only values with Notion AI. Transfer what you need using stable Asana record IDs rather than task names.

4. Update links, linked database views, relations, and automations that should use the replacement. Review sharing permissions on the new databases.

5. Once your team is using the replacement, ask Notion AI to help retire the old sync while keeping the old database available for reference.

You don’t need to delete the old database to use the Worker. Keep it until you’ve checked that your team’s information and workflows are accounted for.

By default, the skill sets up an hourly sync for Projects and Tasks. You can ask Notion AI for a different schedule, from every 5 minutes up to every 7 days, or manual-only. The Worker runs in the background, even when Notion is closed.

Each successful refresh reads the selected projects and their tasks and updates the matching Notion database. Updates flow from Asana to Notion. Make changes to synced values in Asana; changes in Notion aren’t written back.

Your chosen schedule sets how often a refresh starts, not how long it takes to finish. Larger projects and source request limits can delay completion.

Review the replacement databases’ sharing settings before giving your team access. Notion permissions control who can see the imported records; Asana project permissions aren’t applied separately to each Notion viewer.

The Privacy property describes the Asana project. It doesn’t control access to its data in Notion.

Ask Notion AI to check the complete project selection, source access, pagination, and inclusion of completed tasks. Also check the Notion view’s filters. A task that isn’t included in the selected projects may not be returned by this sync.

Check Owner name or Assignee name. A person property can remain empty when the Asana email isn’t available or doesn’t match a Notion member or guest.

Ask Notion AI to check the Worker’s latest runs and credential access. You may need to restart the sync with the complete project list. Repeated manual retries can hit request limits.

The replacement has new databases and record pages. Ask Notion AI to compare the old and new structures and handle each missing value or dependency before retiring the old sync.

• Sync data from other tools to Notion

• Connect GitLab