Submit
MCP Servers2025-09-18

Asana MCP Server for Claude

Interact with Asana workspaces to manage projects and tasks

asanaproject-managementtasksteam-collaborationworkflow

Author

Asana

Added

2025-09-18

Setup time

2 minutes

Difficulty

beginner

Quick use

Install command

1 lines
claude mcp list && claude mcp status asana

Claude config

.claude/settings.json

6 lines
{
  "asana": {
    "url": "https://mcp.asana.com/sse",
    "transport": "sse"
  }
}

Source asset

json

6 lines
{
  "asana": {
    "url": "https://mcp.asana.com/sse",
    "transport": "sse"
  }
}

Section

Content

Expand

Connect Claude to Asana for comprehensive project management and team collaboration.

Section

Features

Expand
  • Create and manage tasks with rich metadata
  • Update project status and milestones
  • Assign team members and collaborators
  • Set due dates and task dependencies
  • Generate progress reports and analytics
  • Advanced Asana project and task management with workspace organization, team collaboration features, and project portfolio tracking
  • Batch operations support for efficient bulk task creation, updates, and assignments with automatic rate limit handling and retry logic
  • Real-time task synchronization capabilities with webhook integration support for monitoring project changes and triggering automated workflows
  • Advanced Asana project and task management with workspace organization, team collaboration features, and project portfolio tracking
  • Batch operations support for efficient bulk task creation, updates, and assignments with automatic rate limit handling and retry logic
  • Real-time task synchronization capabilities with webhook integration support for monitoring project changes and triggering automated workflows

Section

Use Cases

Expand
  • Create tasks from meeting notes
  • Update project timelines and deadlines
  • Assign work to team members efficiently
  • Track milestone progress across projects
  • Generate status reports for stakeholders
  • Build automated project management workflows that sync external systems with Asana projects for real-time task tracking and team coordination
  • Build automated project management workflows that sync external systems with Asana projects for real-time task tracking and team coordination

Section

Installation

Expand

Claude Code

  1. claude mcp add --transport sse asana https://mcp.asana.com/sse
  2. Verify installation: claude mcp list
  3. Test connection: claude mcp status asana
Claude CodeDetails
  1. claude mcp add --transport sse asana https://mcp.asana.com/sse
  2. Verify installation: claude mcp list
  3. Test connection: claude mcp status asana
Claude DesktopDetails
  1. Open Claude Desktop configuration file
  2. Add the Asana server configuration with SSE transport
  3. Restart Claude Desktop
  4. Authenticate via OAuth when prompted

Section

Requirements

Expand
  • OAuth 2.0 authentication (required for MCP server via SSE transport)
  • Asana account with access to at least one workspace
  • Workspace membership with Member role or higher (Guest role insufficient for task creation)
  • Internet connection for accessing Asana API (https://app.asana.com)
  • Claude Desktop 0.7.0+ or Claude Code with MCP support
  • SSE (Server-Sent Events) transport support in MCP client
  • Rate limit awareness: Free tier 150 requests/minute, Paid tier 1,500 requests/minute
  • Understanding of Asana workspace, project, and task structure
  • OAuth scopes: default (access to all endpoints) or specific scopes as needed
  • Access to ~/.mcp-auth directory for OAuth token storage (may need cleanup if authentication fails)

Section

Examples

Expand

Create a task for the new feature

Common usage pattern for this MCP server

Create a task for the new featureDetails

Common usage pattern for this MCP server

Ask Claude: "Create a task for the new feature"
Show all tasks due this weekDetails

Common usage pattern for this MCP server

Ask Claude: "Show all tasks due this week"
Update project status to on-trackDetails

Common usage pattern for this MCP server

Ask Claude: "Update project status to on-track"
Assign task to team memberDetails

Common usage pattern for this MCP server

Ask Claude: "Assign task to team member"
Create Task with DependenciesDetails

Create a new Asana task with project assignment, dependencies, and due date

// Create Asana task with dependencies
const task = await asana.createTask({
  workspace: '1234567890',
  name: 'Complete project documentation',
  projects: ['9876543210'],
  dependencies: ['task-id-1', 'task-id-2'],
  due_on: '2025-12-31'
});
Create Task with DependenciesDetails

Create a new Asana task with project assignment, dependencies, and due date

// Create Asana task with dependencies
const task = await asana.createTask({
  workspace: '1234567890',
  name: 'Complete project documentation',
  projects: ['9876543210'],
  dependencies: ['task-id-1', 'task-id-2'],
  due_on: '2025-12-31'
});

Section

Security

Expand
  • OAuth authentication for secure access
  • Workspace permissions apply automatically
  • Audit trail maintained for all actions
  • Regular permission reviews recommended
  • Asana API tokens and personal access tokens must be securely stored and never exposed in client-side code or public repositories - use environment variables and secure credential management
  • OAuth access tokens should be used for third-party integrations instead of personal access tokens to ensure proper access control and token lifecycle management
  • Asana workspace and project IDs may expose organizational structure and team information - ensure workspace IDs are kept private and not shared in public configurations
  • Rate limiting and API quota management are critical for Asana MCP servers - implement proper rate limit handling, retry logic, and quota monitoring to prevent service disruption
  • Asana webhook configurations and payloads may contain sensitive project and task data - ensure webhook endpoints are properly secured with authentication and HTTPS encryption
  • Asana API tokens and personal access tokens must be securely stored and never exposed in client-side code or public repositories - use environment variables and secure credential management
  • OAuth access tokens should be used for third-party integrations instead of personal access tokens to ensure proper access control and token lifecycle management
  • Asana workspace and project IDs may expose organizational structure and team information - ensure workspace IDs are kept private and not shared in public configurations
  • Rate limiting and API quota management are critical for Asana MCP servers - implement proper rate limit handling, retry logic, and quota monitoring to prevent service disruption
  • Asana webhook configurations and payloads may contain sensitive project and task data - ensure webhook endpoints are properly secured with authentication and HTTPS encryption

Section

Troubleshooting

Expand

OAuth authentication fails or connection times out

Remove ~/.mcp-auth directory with rm -rf ~/.mcp-auth and re-authenticate. Verify SSE URL https://mcp.asana.com/sse is accessible. Logout and re-login to Asana account if errors persist.

OAuth authentication fails or connection times outDetails

Remove ~/.mcp-auth directory with rm -rf ~/.mcp-auth and re-authenticate. Verify SSE URL https://mcp.asana.com/sse is accessible. Logout and re-login to Asana account if errors persist.

Insufficient permissions to create or modify tasksDetails

Verify workspace role is Member or higher (not Guest). Check project permissions allow task creation. Contact workspace admin to upgrade access level if needed.

Rate limit exceeded during bulk task operationsDetails

Free tier: 150 req/min limit. Paid tier: 1,500 req/min. Batch operations into groups of 10-20 tasks. Implement delays between batches. Check Retry-After header in 429 responses.

Tasks not appearing or data appears staleDetails

Run tools/list command to refresh available endpoints. Restart MCP client connection. Verify you're querying correct workspace - switch workspaces if accessing wrong data.

Asana MCP server authentication errors with personal access tokensDetails

Verify token is valid and not expired. Check token scopes match required permissions. Ensure token format is correct (Bearer token in Authorization header). For OAuth integrations, verify token refresh logic is working correctly.

Rate limit errors when managing large Asana projectsDetails

Implement exponential backoff retry logic with jitter. Use batch operations to reduce API calls. Cache frequently accessed data. Monitor rate limit headers and adjust request frequency accordingly.

Asana workspace or project access denied errorsDetails

Verify API token has access to the workspace and projects. Check workspace permissions and project sharing settings. Ensure OAuth scopes include required workspace and project access permissions.

Asana MCP server connection timeouts or network errorsDetails

Check network connectivity and firewall settings. Verify Asana API endpoints are accessible. Increase request timeout values. Implement connection pooling and retry mechanisms with exponential backoff.

Asana MCP server authentication errors with personal access tokensDetails

Verify token is valid and not expired. Check token scopes match required permissions. Ensure token format is correct (Bearer token in Authorization header). For OAuth integrations, verify token refresh logic is working correctly.

Rate limit errors when managing large Asana projectsDetails

Implement exponential backoff retry logic with jitter. Use batch operations to reduce API calls. Cache frequently accessed data. Monitor rate limit headers and adjust request frequency accordingly.

Asana workspace or project access denied errorsDetails

Verify API token has access to the workspace and projects. Check workspace permissions and project sharing settings. Ensure OAuth scopes include required workspace and project access permissions.

Asana MCP server connection timeouts or network errorsDetails

Check network connectivity and firewall settings. Verify Asana API endpoints are accessible. Increase request timeout values. Implement connection pooling and retry mechanisms with exponential backoff.

0% complete