Asana MCP
for AI agents

• add_followers_to_project write

  Add Followers to Project

  Tool to add followers to a project in Asana. Use this tool when you need to add one or more users as followers to a specific project. Followers will receive notifications when tasks are added to the project.

• add_followers_to_task write

  Add Followers to Task

  Tool to add followers to a task in Asana. Use this tool when you need to add one or more users as followers to a specific task. This will notify them of updates to the task.

• add_item_to_portfolio write

  Add item to portfolio

  Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint. Use when a workflow needs to attach a newly created project to a portfolio without using ASANA_SUBMIT_PARALLEL_REQUESTS.

• add_members_to_project write

  Add Members to Project

  Tool to add users to a project in Asana. Use this tool when you need to add one or more users as members to a specific project. Members can view and contribute to the project.

• add_project_for_task write

  Add Project to Task

  Tool to add a project to a task in Asana. Use when you need to associate a task with a project. Optionally position the task within the project using insert_before, insert_after, or section parameters.

• add_supporting_relationship write

  Add Supporting Relationship to Goal

  Tool to add a supporting goal relationship to a goal. Use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in Asana.

• add_tag_to_task write

  Add Tag to Task

  Tool to add an existing tag to a task in Asana. Use when you need to add a tag for prioritization, routing, or automation workflows. Tags cannot be added via Update Task, so this dedicated endpoint is required.

• add_task_dependencies write

  Add Task Dependencies

  Tool to add dependency relationships to an Asana task. Use when you need to mark one or more tasks as prerequisites (dependencies) for another task, ensuring the dependency tasks must be completed first.

• add_task_to_section write

  Add task to section

  Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.

• add_user_to_team write

  Add User for Team

  Tool to add a user to a team in Asana. Use this when you need to add a user to a specific team by providing their user GID, email, or "me" for the current user.

• add_user_to_workspace write

  Add User for Workspace

  Tool to add a user to a workspace or organization in Asana. Use this when you need to add a user to a specific workspace by providing their user GID, email, or "me" for the current user.

• approve_access_request write

  Approve Access Request

  Tool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.

• create_access_request write

  Create Access Request

  Tool to create an access request in Asana. Use when you need to request access to a project or portfolio that you don't currently have access to.

• create_allocation write

  Create Allocation

  Creates a new allocation. Use when you need to schedule or assign a specific amount of a user's time per week to a task or project within a defined period.

• create_a_project write

  Create a project

  Creates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.

• create_a_tag_in_a_workspace write

  Create a tag in a workspace

  Creates a new tag, with properties like name and color defined in the request body, within a specific Asana workspace (using `workspace_gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.

• create_a_task write

  Create task in asana with specific details

  Creates a new Asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.

• create_attachment_for_object write

  Create Attachment for Object

  Tool to upload an attachment or link an external resource to a task, project, or project_brief in Asana. Use when you need to attach a file or external URL to any Asana object.

• create_attachment_for_task write

  Create Attachment for Task

  Tool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.

• create_custom_field write

  Create Custom Field

  Tool to create a new custom field in a workspace. Use when you need to define a new field for tracking specific information within Asana tasks.

• create_enum_option_for_custom_field write

  Create Enum Option for Custom Field

  Tool to create a new enum option for a custom field in Asana. Use this when you need to add a new selectable option to an existing custom field.

• create_membership write

  Create Membership

  Tool to create a membership by adding a user or team to a project, goal, or portfolio. Use when you need to grant access to an Asana resource.

• create_project_brief write

  Create Project Brief

  Tool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.

• create_project_for_team write

  Create project for team

  Tool to create a project in a team. Use when you need to create a new project within a specific Asana team.

• create_project_for_workspace write

  Create project for workspace

  Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace. Note: The team field is required when creating projects in workspaces.

• create_project_status_update write

  Create Project Status Update

  Tool to create a new status update on a project. Use when you need to communicate the current status, progress, or any blockers related to a specific project.

• create_section_in_project write

  Create a section in a project

  Creates a new SECTION (not a task) in a project. Sections are organizational containers within a project used to group and categorize tasks (e.g., 'To Do', 'In Progress', 'Done', 'Backlog'). The new section can be optionally positioned relative to an existing section in the same project. IMPORTANT: This action creates SECTIONS only. Do NOT use this action to create tasks. To create a task, use the ASANA_CREATE_A_TASK action instead. Task-related fields like 'assignee', 'notes', 'due_date', 'description' are NOT supported by this action.

• create_status_for_object write

  Create Status Update for Object

  Tool to create a status update on a project, portfolio, or goal. Use when you need to communicate progress, blockers, or current state to all followers of an object.

• create_subtask write

  Create subtask

  Creates a new Asana subtask under an existing parent task (`task_gid`); `due_on` and `due_at` are mutually exclusive and cannot be set simultaneously.

• create_tag write

  Create a tag

  Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks. Tags help organize and filter tasks across projects but are not automatically applied to any tasks.

• create_task_comment write

  Create task comment

  Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.

• create_team write

  Create Team

  Tool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.

• delete_allocation write

  Delete Allocation

  Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.

• delete_attachment write

  Delete Attachment

  Tool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.

• delete_custom_field write

  Delete Custom Field

  Tool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.

• delete_membership write

  Delete Membership

  Tool to delete a membership by its GID. Use this when you need to remove a user or team's access to a project, portfolio, goal, or custom field in Asana.

• delete_project write

  Delete a project

  Delete a project.

• delete_project_brief write

  Delete Project Brief

  Tool to delete a project brief by its GID. Use when you need to remove a project brief from Asana. Note: This requires the project_brief_gid (not the project_gid).

• delete_project_status write

  Delete Project Status

  Tool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.

• delete_section write

  Delete a section

  Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.

• delete_status_update write

  Delete Status Update

  Tool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.

• delete_story write

  Delete Story

  Tool to delete a story by its GID. Use when you need to remove a story from Asana.

• delete_tag write

  Delete a Tag

  Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.

• delete_task write

  Delete a task

  Delete a task.

• duplicate_project write

  Duplicate Project

  Duplicate a project.

• duplicate_task write

  Duplicate Task

  Duplicate a task

• get_access_requests read

  Get Access Requests

  Tool to retrieve access requests for a target object. Use when you need to get pending access requests for a specific resource like a project or portfolio.

• get_allocation read

  Get Allocation

  Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.

• get_allocations read

  Get Allocations

  Tool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.

• get_a_project read

  Get a project

  Retrieves a specific Asana project by its `project_gid`, with an option to include additional fields for comprehensive details using `opt_fields`; this action does not return tasks within the project.

• get_a_task read

  Get a task

  Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.

• get_attachment read

  Get Attachment

  Tool to get a single attachment by its globally unique identifier. Use when you need to retrieve details about a specific file attached to a task or project.

• get_audit_log_events read

  Get Audit Log Events

  Tool to get audit log events for a workspace. Use when you need to retrieve a log of actions performed within a specific Asana workspace.

• get_a_user_task_list read

  Get a user task list

  Retrieves a specific user's task list from Asana by its `user_task_list_gid`, optionally returning extended details like name, owner, and workspace if specified in `opt_fields`.

• get_current_user read

  Get current user

  Retrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.

• get_custom_field read

  Get Custom Field

  Tool to get a single custom field by its globally unique identifier. Use when you need to retrieve the complete metadata and properties of a specific custom field in Asana.

• get_custom_fields_for_workspace read

  Get Custom Fields for Workspace

  Tool to get all custom fields in a workspace. Use when you need to retrieve a list of custom fields associated with a specific workspace.

• get_custom_types read

  Get Custom Types

  Tool to get all custom types associated with a project. Use when you need to retrieve custom types that extend Asana objects for categorization purposes.

• get_events read

  Get Events on a Resource

  Retrieve events on a resource to monitor changes. Use when you need to track activity or changes related to a specific Asana resource like a task, project, or tag.

• get_favorites_for_user read

  Get Favorites for User

  Tool to get a user's favorites within a specified workspace. Returns favorites ordered as they appear in the user's Asana sidebar.

• get_goal read

  Get Goal

  Retrieve the full record for a single goal by its GID.

• get_goal_relationships read

  Get Goal Relationships

  Tool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.

• get_goals read

  Get Goals

  Tool to retrieve multiple goals. Requires exactly one scope parameter (workspace, team, portfolio, or project) to be specified. Can be optionally filtered by time period or archived status.

• get_job read

  Get Job

  Tool to retrieve a job by its globally unique identifier. Use when you need to check the status of asynchronous operations like task duplication, project instantiation, or exports.

• get_membership read

  Get Membership

  Tool to retrieve a single membership by its ID. Use this when you need to get details about a specific membership relationship between a user/team and a goal, project, portfolio, or custom field.

• get_memberships read

  Get Memberships

  Tool to retrieve memberships for goals, projects, portfolios, or custom fields. Use this to find out who has access to a specific Asana resource or what resources a specific user/team has access to.

• get_multiple_projects read

  Get multiple projects

  Returns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.

• get_multiple_tasks read

  Get multiple tasks

  Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`; `workspace` also requires `assignee`.

• get_multiple_users read

  Get multiple users

  Returns a list of users in an Asana workspace or organization, optionally filtered by workspace or team GID, with support for pagination and specifying optional fields.

• get_multiple_workspaces read

  Get multiple workspaces

  Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.

• get_portfolio read

  Get Portfolio

  Retrieve the full record for a single portfolio by its GID. Use this when you need to get detailed information about a specific portfolio.

• get_portfolio_items read

  Get Portfolio Items

  Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.

• get_portfolio_memberships read

  Get Portfolio Memberships

  Tool to retrieve multiple portfolio memberships. Use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.

• get_portfolios read

  Get Portfolios

  Retrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.

• get_project_brief read

  Get Project Brief

  Tool to retrieve a project brief by its GID. Use when you need to get the detailed explanation (what and why) of a project. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

• get_project_membership read

  Get Project Membership

  Tool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.

• get_project_memberships read

  Get Project Memberships For Project

  Tool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.

• get_projects_for_task read

  Get Projects for Task

  Tool to get all projects a task is in. Use when you need to retrieve project associations for a specific task.

• get_projects_for_team read

  Get Projects for Team

  Tool to get a list of projects for a specific team in Asana. Use when you need to retrieve project details associated with a team.

• get_project_status read

  Get Project Status

  Tool to retrieve the full record for a single project status by its GID. Use when you need to get the details of a specific project status update.

• get_project_status_updates read

  Get Project Status Updates

  Tool to get status updates for a specific project. Use when you need to retrieve the latest or historical status reports associated with an Asana project.

• get_project_templates read

  Get Multiple Project Templates

  Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.

• get_project_templates_for_team read

  Get Project Templates for Team

  Tool to get a team's project templates in Asana. Use when you need to retrieve project templates associated with a specific team.

• get_reactions_on_object read

  Get Reactions on Object

  Tool to get reactions with a specific emoji base character on an object. Use when you need to retrieve user reactions (emoji responses) on a status update or story.

• get_section read

  Get Section

  Retrieve the full record for a single section by its GID. Use this when you need to get details about a specific section within a project.

• get_sections_in_project read

  Get sections in a project

  Returns compact records for all sections (used to group tasks) in a specified project.

• get_status read

  Get Status Update

  Tool to retrieve the full record for a single status update by its GID. Use when you need to get the details of a specific status update.

• get_status_updates read

  Get Status Updates

  Retrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.

• get_stories_for_task read

  Get Stories for Task

  Tool to get stories (comments, status updates, etc.) for a task. Use when you need to retrieve the history or discussion associated with a specific task.

• get_story read

  Get Story

  Tool to retrieve a story. Use when you need to get the complete record for a single story.

• get_tag read

  Get Tag

  Tool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.

• get_tags read

  Get Tags

  Get multiple tags in a workspace.

• get_tags_for_task read

  Get Tags for Task

  Tool to get all tags associated with a specific task. Use when you need to retrieve tags for categorization, filtering, or understanding task organization.

• get_tags_for_workspace read

  Get Tags For Workspace

  Tool to get all tags in a specific workspace. Use when you need to retrieve tags for categorizing tasks within a workspace.

• get_task_attachments read

  Get Task Attachments

  Tool to get the list of attachments for a given task, project, or project_brief. Use when you need to retrieve files attached to a specific Asana object.

• get_task_counts_for_project read

  Get Task Counts For Project

  Tool to get task count statistics for a project. Use when you need to retrieve the number of tasks, completed tasks, incomplete tasks, and milestone counts for a specific Asana project. Note that all fields are excluded by default - you must specify them in opt_fields to get any data.

• get_tasks_for_tag read

  Get tasks for tag

  Tool to retrieve tasks associated with a specific Asana tag by tag GID. Use when you need to list all tasks that have been tagged with a particular label.

• get_tasks_for_user_task_list read

  Get tasks for user task list

  Tool to retrieve tasks from a user task list by user task list GID. Use when you need to list tasks assigned to a specific user's task list.

• get_tasks_from_a_project read

  Retrieve tasks for project

  Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.

• get_tasks_from_section read

  Get tasks from a section

  Tool to retrieve tasks that belong to a specific Asana section (column/header) by section GID. Use when you need to list tasks within a particular section, such as for agenda or carryover workflows. Board view only feature.

• get_task_subtasks read

  Get Task Subtasks

  Tool to retrieve multiple task subtasks from a workspace. Use when you need to list or find available task subtasks.

• get_task_templates read

  Get Task Templates

  Tool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.

• get_team read

  Get Team

  Tool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.

• get_team_membership read

  Get Team Membership

  Tool to retrieve a complete team membership record by its GID. Use when you need to fetch details about a specific team membership in Asana.

• get_team_memberships read

  Get Team Memberships

  Tool to retrieve compact team membership records. Use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.

• get_team_memberships_for_team read

  Get Team Memberships for Team

  Tool to get memberships from a specific team. Use when you need to retrieve the list of users who are members of a particular team, including their membership details such as admin status and guest status.

• get_team_memberships_for_user read

  Get Team Memberships For User

  Tool to get team memberships for a specific user. Use when you need to retrieve all teams that a user belongs to within a workspace.

• get_teams_for_user read

  Get Teams for User

  Tool to get teams for a specific user in an organization. Returns the team records for all teams in the organization or workspace to which the given user is assigned.

• get_teams_in_workspace read

  Get teams in workspace

  Returns the compact records for all teams in the workspace visible to the authorized user.

• get_time_period read

  Get Time Period

  Tool to retrieve the full record for a single time period by its GID. Use when you need to fetch detailed information about a specific time period, including its start/end dates, display name, and parent period.

• get_time_periods read

  Get Time Periods

  Tool to retrieve compact or full representations of time periods. Use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.

• get_time_tracking_entries read

  Get Time Tracking Entries

  Tool to get multiple time tracking entries across workspace, tasks, or projects. Use when you need to retrieve time tracking information for filtering by workspace, task, portfolio, user, or date range.

• get_time_tracking_entries_for_task read

  Get Time Tracking Entries for Task

  Tool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.

• get_typeahead_objects read

  Get Objects via Typeahead

  Tool to retrieve objects in a workspace via a typeahead search algorithm. Use when you need to quickly find objects like tasks, projects, users, etc., based on a search string. This is useful for implementing auto-completion features.

• get_user read

  Get User

  Get a user by their ID.

• get_user_for_workspace read

  Get User in Workspace

  Tool to get a user in a workspace or organization by their GID. Use when you need to retrieve details about a specific user within a workspace context.

• get_users_for_team read

  Get Users for Team

  Get users in a team.

• get_users_for_workspace read

  Get Users in Workspace

  Get users in a workspace or organization.

• get_user_task_list read

  Get User Task List

  Tool to get a single user task list by its globally unique identifier. Use when you need to retrieve information about a specific user's My Tasks list.

• get_webhooks read

  Get Webhooks

  Tool to retrieve multiple webhooks in a workspace. Use when you need to list all webhooks for a workspace or filter webhooks by a specific resource.

• get_workspace read

  Get Workspace

  Tool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.

• get_workspace_membership read

  Get Workspace Membership

  Tool to retrieve a specific workspace membership by its GID. Use when you need to get details about a user's membership in a workspace.

• get_workspace_memberships read

  Get Workspace Memberships

  Tool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.

• get_workspace_memberships_for_user read

  Get Workspace Memberships For User

  Tool to retrieve workspace memberships for a specific user. Use when you need to list all workspaces a user is a member of.

• get_workspace_projects read

  Get Workspace Projects

  Tool to retrieve the projects associated with a specific workspace. Use when you need to list all projects within a given Asana workspace.

• insert_enum_option_for_custom_field write

  Reorder Enum Option for Custom Field

  Tool to reorder an existing enum option within a custom field by moving it before or after another specified enum option. Use when you need to change the order/position of options in an enum or multi_enum custom field. Note: To create new enum options, use 'Create Enum Option for Custom Field' action instead.

• insert_section_for_project write

  Move or Insert Section in Project

  Tool to move or reorder an existing section within a project by repositioning it before or after another section. Use when you need to change the position/order of sections in a project. Note: This action moves existing sections only. To create new sections, use 'Create Section in Project' action instead.

• instantiate_project_template write

  Instantiate Project Template

  Instantiate (create) a real Asana project from a project template, returning the async job record. Use when you need to create a new project from a template with specific date and role assignments.

• reject_access_request write

  Reject access request

  Tool to reject an access request. Use when you need to deny a user's request for access to a project or resource.

• remove_follower_from_task write

  Remove Follower From Task

  Tool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.

• remove_followers_for_project write

  Remove Followers For Project

  Tool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.

• remove_item_from_portfolio write

  Remove Item from Portfolio

  Tool to remove an item (e.g., a project) from an Asana portfolio. Use to undo/cleanup portfolio membership, support moves between portfolios, or enforce portfolio hygiene.

• remove_members_for_project write

  Remove Members from Project

  Tool to remove users from a project in Asana. Use this tool when you need to remove one or more users as members from a specific project.

• remove_project_from_task write

  Remove Project from Task

  Tool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.

• remove_tag_from_task write

  Remove Tag from Task

  Tool to remove an existing tag from a task in Asana. Use this tool when you need to detach a tag from a specific task for cleanup or retagging automation.

• remove_user_for_team write

  Remove User For Team

  Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.

• remove_user_for_workspace write

  Remove User from Workspace

  Tool to remove a user from a workspace or organization. Use when you need to revoke a user's access to a specific workspace.

• search_tasks_in_workspace read

  Search Tasks in Workspace

  Tool to search tasks across a workspace with advanced filters. Use when performing complex queries such as overdue tasks, by project or custom field, for reporting or automation.

• set_parent_for_task write

  Set parent for task

  Tool to set the parent of a task in Asana. Use when you need to make a task a subtask of another task or remove the parent relationship.

• submit_parallel_requests write

  Submit Parallel Requests (Batch API)

  Tool to submit multiple Asana API requests in parallel using the Batch API. Use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.

• update_allocation write

  Update Allocation

  Tool to update an existing allocation by its ID. Use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.

• update_a_task write

  Update a task

  Updates attributes of an existing Asana task identified by its task_gid.

• update_custom_field write

  Update Custom Field

  Tool to update a custom field by its globally unique identifier. Use when you need to modify properties of an existing custom field in Asana.

• update_enum_option write

  Update Enum Option

  Tool to update an enum option for a custom field. Use when you need to modify the name, color, or enabled status of an existing enum option.

• update_project write

  Update a project

  Update a project.

• update_project_brief write

  Update Project Brief

  Tool to update a project brief by its GID. Use when you need to modify the content/description of a project brief. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

• update_section write

  Update Section

  Update a section's name or position within a project. Use when you need to rename a section or reorder sections by specifying insert_before or insert_after.

• update_story write

  Update Story

  Tool to update a story on a task. Use when you need to modify the text, html_text, or pin status of an existing story. Only comment stories can have text/html_text updated, and only comment and attachment stories can be pinned.

• update_tag write

  Update Tag

  Tool to update an existing tag by its globally unique identifier. Use when you need to change the name or color of a tag.

• update_team write

  Update a team

  Tool to update details of an existing team. Use when you need to change a team's name, description, or organization.

• update_user write

  Update User

  Update a user's custom fields. Note: Asana's API has very limited user update capabilities - most user properties are read-only and managed by users themselves.

• update_user_for_workspace write

  Update User for Workspace

  Tool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.

• update_webhook write

  Update a webhook

  Tool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.

No tools match your search.