Asana
Connect Asana to manage tasks, subtasks, projects, sections, custom fields, tags, portfolios, and goals for your team.
You paste a single Asana Personal Access Token, generated in the Asana developer console and shown only once.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- https://app.asana.com/api/1.0
- Rate limits
- 150 requests per minute on free domains and 1,500 per minute on paid domains. The search API is capped at 60 per minute. Over-limit calls return 429 with a Retry-After header.
Before you begin
- An Asana account on any plan: Personal, Starter, Advanced or Enterprise.
- The token acts as you. It reaches only the workspaces, teams and projects your own user can already see.
- On Enterprise, an admin may have restricted app and token creation.
Get your credentials
Open the Asana developer console
Go to https://app.asana.com/0/my-apps. From inside Asana, click your profile photo, then My Settings → Apps → Manage Developer Apps.
Create a new personal access token
In the console sidebar click Personal access tokens, then click + Create new token.
Personal access tokens
Tokens that authenticate scripts and integrations as your Asana user.
| Name | Created | Last used | Status |
|---|---|---|---|
| Reporting script2/1204****7c31 | Mar 4, 2026 | Aug 20, 2026 | Active |
| Old sheet sync2/1198****0ab4 | Nov 2, 2025 | Never | Unused |
Existing tokens stay listed here, so you can revoke one without touching the others.
Name the token and accept the API terms
Type PopMCP in Token name, tick I agree to the Asana API Terms, and click Create token.
Personal access tokens
Tokens that authenticate scripts and integrations as your Asana user.
There is no scope picker. The token inherits everything your Asana user can reach.
Copy the token into PopMCP
Click Copy in the dialog, then paste the string into PopMCP's Personal Access Token field.
Personal access tokens
Tokens that authenticate scripts and integrations as your Asana user.
Asana treats token strings as opaque. The prefix may differ from the one shown here.
Connect in PopMCP
Open your workspace, choose Asana in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Personal Access Tokensecret | Asana → your profile photo → My Settings → Apps → Developer console (or app.asana.com/0/my-apps) → Personal access tokens → Create new token. The token is shown only once. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Asana immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
The Asana connection shows Connected in PopMCP and the Asana tools load. Listing your workspaces or the tasks assigned to you returns real Asana records.
Troubleshooting
You closed the dialog before copying the token
Why: Asana reveals the full string once and never again.
Fix: Delete that entry on the Personal access tokens page and create a new token.
401 Unauthorized
Why: The token was truncated on copy, or it has since been deleted from the developer console.
Fix: Open app.asana.com/0/my-apps, go to Personal access tokens, delete the old entry, create a fresh token and paste the whole string.
403 Forbidden on a specific project
Why: The token inherits your access, and your user is not a member of that project or team.
Fix: Add your user to the project or team in Asana, or generate the token from a user that already has access.
429 Too Many Requests
Why: The domain's per-minute quota was exceeded: 150 on free domains, 1,500 on paid, 60 for search.
Fix: Wait the number of seconds given in the Retry-After header before retrying. Early retries still count against the quota.
The token works but sees none of your team's work
Why: It was created from a personal Asana account that is not a member of the organisation's workspace.
Fix: Sign in to the Asana account that belongs to the organisation, switch to that workspace, and create the token again from app.asana.com/0/my-apps.