Asana Integration ↗

Summary: Team task and project coordination with Asana integration for CrewAI.

Original Documentation

Documentation Index#
Fetch the complete documentation index at: https://docs.crewai.com/llms.txt Use this file to discover all available pages before exploring further.

Team task and project coordination with Asana integration for CrewAI.

Overview#

Enable your agents to manage tasks, projects, and team coordination through Asana. Create tasks, update project status, manage assignments, and streamline your team’s workflow with AI-powered automation.

Prerequisites#

Before using the Asana integration, ensure you have:

A CrewAI AMP account with an active subscription
An Asana account with appropriate permissions
Connected your Asana account through the Integrations page

Setting Up Asana Integration#

1. Connect Your Asana Account#

Navigate to CrewAI AMP Integrations
Find Asana in the Authentication Integrations section
Click Connect and complete the OAuth flow
Grant the necessary permissions for task and project management
Copy your Enterprise Token from Integration Settings

2. Install Required Package#

uv add crewai-tools

3. Environment Variable Setup#

To use integrations with Agent(apps=[]), you must set the CREWAI_PLATFORM_INTEGRATION_TOKEN environment variable with your Enterprise Token.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

Or add it to your .env file:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

Available Actions#

**Description:** Create a comment in Asana.

Parameters:

task (string, required): Task ID - The ID of the Task the comment will be added to. The comment will be authored by the currently authenticated user.
text (string, required): Text (example: “This is a comment.”).

Description: Create a project in Asana.

Parameters:

name (string, required): Name (example: “Stuff to buy”).
workspace (string, required): Workspace - Use Connect Portal Workflow Settings to allow users to select which Workspace to create Projects in. Defaults to the user’s first Workspace if left blank.
team (string, optional): Team - Use Connect Portal Workflow Settings to allow users to select which Team to share this Project with. Defaults to the user’s first Team if left blank.
notes (string, optional): Notes (example: “These are things we need to purchase.”).

Description: Get a list of projects in Asana.

Parameters:

archived (string, optional): Archived - Choose “true” to show archived projects, “false” to display only active projects, or “default” to show both archived and active projects.
- Options: default, true, false

Description: Get a project by ID in Asana.

Parameters:

projectFilterId (string, required): Project ID.

Description: Create a task in Asana.

Parameters:

name (string, required): Name (example: “Task Name”).
workspace (string, optional): Workspace - Use Connect Portal Workflow Settings to allow users to select which Workspace to create Tasks in. Defaults to the user’s first Workspace if left blank..
project (string, optional): Project - Use Connect Portal Workflow Settings to allow users to select which Project to create this Task in.
notes (string, optional): Notes.
dueOnDate (string, optional): Due On - The date on which this task is due. Cannot be used together with Due At. (example: “YYYY-MM-DD”).
dueAtDate (string, optional): Due At - The date and time (ISO timestamp) at which this task is due. Cannot be used together with Due On. (example: “2019-09-15T02:06:58.147Z”).
assignee (string, optional): Assignee - The ID of the Asana user this task will be assigned to. Use Connect Portal Workflow Settings to allow users to select an Assignee.
gid (string, optional): External ID - An ID from your application to associate this task with. You can use this ID to sync updates to this task later.

Description: Update a task in Asana.

Parameters:

taskId (string, required): Task ID - The ID of the Task that will be updated.
completeStatus (string, optional): Completed Status.
- Options: true, false
name (string, optional): Name (example: “Task Name”).
notes (string, optional): Notes.
dueOnDate (string, optional): Due On - The date on which this task is due. Cannot be used together with Due At. (example: “YYYY-MM-DD”).
dueAtDate (string, optional): Due At - The date and time (ISO timestamp) at which this task is due. Cannot be used together with Due On. (example: “2019-09-15T02:06:58.147Z”).
assignee (string, optional): Assignee - The ID of the Asana user this task will be assigned to. Use Connect Portal Workflow Settings to allow users to select an Assignee.
gid (string, optional): External ID - An ID from your application to associate this task with. You can use this ID to sync updates to this task later.

Description: Get a list of tasks in Asana.

Parameters:

workspace (string, optional): Workspace - The ID of the Workspace to filter tasks on. Use Connect Portal Workflow Settings to allow users to select a Workspace.
project (string, optional): Project - The ID of the Project to filter tasks on. Use Connect Portal Workflow Settings to allow users to select a Project.
assignee (string, optional): Assignee - The ID of the assignee to filter tasks on. Use Connect Portal Workflow Settings to allow users to select an Assignee.
completedSince (string, optional): Completed since - Only return tasks that are either incomplete or that have been completed since this time (ISO or Unix timestamp). (example: “2014-04-25T16:15:47-04:00”).

Description: Get a list of tasks by ID in Asana.

Parameters:

taskId (string, required): Task ID.

Description: Get a task by external ID in Asana.

Parameters:

gid (string, required): External ID - The ID that this task is associated or synced with, from your application.

Description: Add a task to a section in Asana.

Parameters:

sectionId (string, required): Section ID - The ID of the section to add this task to.
taskId (string, required): Task ID - The ID of the task. (example: “1204619611402340”).
beforeTaskId (string, optional): Before Task ID - The ID of a task in this section that this task will be inserted before. Cannot be used with After Task ID. (example: “1204619611402340”).
afterTaskId (string, optional): After Task ID - The ID of a task in this section that this task will be inserted after. Cannot be used with Before Task ID. (example: “1204619611402340”).

Description: Get a list of teams in Asana.

Parameters:

workspace (string, required): Workspace - Returns the teams in this workspace visible to the authorized user.

Description: Get a list of workspaces in Asana.

Parameters: None required.

Usage Examples#

Basic Asana Agent Setup#

from crewai import Agent, Task, Crew

# Create an agent with Asana capabilities
asana_agent = Agent(
    role="Project Manager",
    goal="Manage tasks and projects in Asana efficiently",
    backstory="An AI assistant specialized in project management and task coordination.",
    apps=['asana']  # All Asana actions will be available
)

# Task to create a new project
create_project_task = Task(
    description="Create a new project called 'Q1 Marketing Campaign' in the Marketing workspace",
    agent=asana_agent,
    expected_output="Confirmation that the project was created successfully with project ID"
)

# Run the task
crew = Crew(
    agents=[asana_agent],
    tasks=[create_project_task]
)

crew.kickoff()

Filtering Specific Asana Tools#

from crewai import Agent, Task, Crew

# Create agent with specific Asana actions only
task_manager_agent = Agent(
    role="Task Manager",
    goal="Create and manage tasks efficiently",
    backstory="An AI assistant that focuses on task creation and management.",
    apps=[
        'asana/create_task',
        'asana/update_task',
        'asana/get_tasks'
    ]  # Specific Asana actions
)

# Task to create and assign a task
task_management = Task(
    description="Create a task called 'Review quarterly reports' and assign it to the appropriate team member",
    agent=task_manager_agent,
    expected_output="Task created and assigned successfully"
)

crew = Crew(
    agents=[task_manager_agent],
    tasks=[task_management]
)

crew.kickoff()

Advanced Project Management#

from crewai import Agent, Task, Crew

project_coordinator = Agent(
    role="Project Coordinator",
    goal="Coordinate project activities and track progress",
    backstory="An experienced project coordinator who ensures projects run smoothly.",
    apps=['asana']
)

# Complex task involving multiple Asana operations
coordination_task = Task(
    description="""
    1. Get all active projects in the workspace
    2. For each project, get the list of incomplete tasks
    3. Create a summary report task in the 'Management Reports' project
    4. Add comments to overdue tasks to request status updates
    """,
    agent=project_coordinator,
    expected_output="Summary report created and status update requests sent for overdue tasks"
)

crew = Crew(
    agents=[project_coordinator],
    tasks=[coordination_task]
)

crew.kickoff()

Link last verified June 7, 2026. View original ↗

Source: CrewAI Docs

Link last verified: 2026-03-04