How to Connect Asana MCP to an AI Agent
Auth setup
1. Follow Asana dev docs to get client_id and client_secret. 2. claude mcp add --transport http --client-id YOUR_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp. 3. OAuth browser flow triggers on first use.
Key facts
| Base URL | https://app.asana.com/api/1.0/ |
|---|
| API version | 1.0 |
|---|
| Auth | OAuth 2.0 with pre-registration. Requires client_id and client_secret obtained through Asana developer docs integration guide. V2 server provides better security and organizational control. |
|---|
| Token URL | https://app.asana.com/-/oauth_token |
|---|
| Scopes | default (full access) |
|---|
| Request body | application/json |
|---|
| Pagination | Cursor-based: next_page.offset in response. Pass as offset query param. |
|---|
| Rate limit | 1,500 req/min per PAT. Free tier: 150 req/min. Retry-After header on 429. |
|---|
| Error format | JSON: {"errors":[{"message":"...","help":"...","phrase":"..."}]} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /workspaces | List all workspaces |
POST | /tasks | Create a task |
GET | /tasks/{id} | Get task details |
GET | /projects/{id}/tasks | List tasks in a project |
POST | /tasks/{id}/subtasks | Create a subtask |
Quickstart
# Claude Code setup:
claude mcp add --transport http \
--client-id YOUR_CLIENT_ID \
--client-secret \
--callback-port 8080 \
asana https://mcp.asana.com/v2/mcp
# Then ask Claude:
# 'Show my Asana tasks due this week'
# 'Create a task in Project X: Review PR #42'
# 'Update task status to completed'
Agent pitfalls & tips
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-06-08. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is Asana MCP's AEO score?
▼
Asana MCP has an AEO score of 0.90 and is rated AA (Strong agent support with minor gaps). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is Asana MCP AI-agent-ready?
▼
Asana MCP is currently ✓ verified for AI agent use. It offers an official MCP (Model Context Protocol) server, which means AI agents can connect directly. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Asana MCP compare to other Project Management services?
▼
In the Project Management category, Asana MCP is rated AA. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how Asana MCP compares.
How can I integrate Asana MCP with an AI agent?
▼
The fastest way to integrate Asana MCP with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with Asana MCP?
▼
OAuth 2.0 with pre-registration. Requires client_id and client_secret obtained through Asana developer docs integration guide. V2 server provides better security and organizational control. Setup: 1. Follow Asana dev docs to get client_id and client_secret. 2. claude mcp add --transport http --client-id YOUR_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp. 3. OAuth browser flow triggers on first use.
What are Asana MCP's API rate limits?
▼
1,500 req/min per PAT. Free tier: 150 req/min. Retry-After header on 429.