Asana integration
Work management platform API for teams to organize, track, and collaborate on projects and tasks. Manage tasks, projects, teams, and workspaces with support for assignments, due dates, comments, custom fields, and workflow automation. Perfect for building project management tools, task trackers, and team collaboration applications.
Say what should happen.
The workflow builds itself.
Common Asana use cases
- workspace maintenance
- tag cleanup
- kanban boards
- file downloads
- project cleanup
- custom data setup
- webhook management
- field configuration
- stakeholder updates
- task categorization
What you can do with Asana
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Task, 16 operations
add_followers_to_taskAdd followers to taskPOSTAdds users as followers to receive task notifications.add_tag_to_taskAdd tag to taskPOSTAdds a tag to a task for labeling and categorization.add_task_to_projectAdd task to projectPOSTAdds a task to a project, allowing tasks to exist in multiple projects.create_taskCreate taskPOSTCreates a new task in Asana with specified properties. Required: workspace or at least one project. Optional: name, notes (description), assignee (user GID), due_on/due_at (dates), tags, followers, and custom_fields. Tasks can belong to multiple p...delete_taskDelete taskDELETEPermanently deletes an Asana task by its GID. Removes the task and its history (stories/comments) from all projects it belongs to. This operation is irreversible - deleted tasks cannot be recovered. Returns an empty successful response upon comple...duplicate_taskDuplicate taskPOSTCreates a copy of an existing task with optional inclusion of subtasks, attachments, and custom fields.get_taskGet taskGETRetrieves complete details of an Asana task by its GID (Global ID). Returns name, notes (description), completed status, due_on/due_at dates, assignee, projects, tags, followers, custom fields, and more. Use opt_fields to control response size by ...get_tasksGet tasksGETRetrieves tasks filtered by project GID, assignee (user GID or 'me'), workspace, or completion date. Returns task names, completion status, due dates, custom fields, and other properties. Use opt_fields to specify which task properties to return. ...get_tasks_for_sectionGet tasks for sectionGETLists all tasks in a specific section for kanban or grouped views.get_tasks_for_tagGet tasks for tagGETLists all tasks with a specific tag across all projects.remove_followers_from_taskRemove followers from taskPOSTRemoves users from a task's follower list to stop notifications.remove_tag_from_taskRemove tag from taskPOSTRemoves a tag from a task without deleting the tag.remove_task_from_projectRemove task from projectPOSTRemoves a task from a project without deleting the task.search_tasksSearch tasksGETSearches for tasks across an Asana workspace with powerful filtering. Supports text search, assignee, project, completion, and custom field filters.set_task_parentSet task parentPOSTSets or removes the parent of a task to organize task hierarchy.update_taskUpdate taskPUTUpdates properties of an existing Asana task. Include only the fields you want to change in the request body. Supports updating name, notes, completed status (set to true to mark done), due_on/due_at, assignee, followers, and custom fields. Return...
Project, 10 operations
add_followers_to_projectAdd followers to projectPOSTAdds users as project followers to receive update notifications.add_members_to_projectAdd members to projectPOSTAdds users as project members with edit access.create_projectCreate projectPOSTCreates a new project in an Asana workspace or team. Sets up a container for organizing related tasks with customizable settings.delete_projectDelete projectDELETEPermanently deletes a project. Tasks remain but lose project association.duplicate_projectDuplicate projectPOSTCreates a copy of a project with selected elements like tasks, sections, and custom fields.get_projectGet projectGETRetrieves detailed information about an Asana project. Returns name, description, team, custom fields, and status for project management.get_projectsGet projectsGETLists all projects in an Asana workspace or team. Returns project names, colors, and status for project navigation and selection.remove_followers_from_projectRemove followers from projectPOSTRemoves users from following a project to stop notifications.remove_members_from_projectRemove members from projectPOSTRemoves users from project membership and access.update_projectUpdate projectPUTUpdates project properties like name, description, color, and archived status.
Section, 6 operations
add_task_to_sectionAdd task to sectionPOSTMoves a task into a section for kanban-style organization.create_sectionCreate sectionPOSTCreates a new section in an Asana project. Adds a workflow stage or category for organizing tasks within the project.delete_sectionDelete sectionDELETEDeletes a section, moving its tasks to no section.get_sectionGet sectionGETRetrieves details of a specific section for display or editing.get_sectionsGet sectionsGETLists all sections in an Asana project. Returns section names and order for organizing tasks into categories or workflow stages.update_sectionUpdate sectionPUTUpdates a section's name or properties.
Customfield, 5 operations
create_custom_fieldCreate custom fieldPOSTCreates a new custom field with specified type and options.delete_custom_fieldDelete custom fieldDELETEPermanently deletes a custom field and removes it from all tasks.get_custom_fieldGet custom fieldGETRetrieves details of a custom field including type and enum options.get_custom_fields_for_workspaceGet custom fields for workspaceGETLists all custom fields in a workspace for structured task data.update_custom_fieldUpdate custom fieldPUTUpdates a custom field's name, description, or settings.
Story, 5 operations
add_task_commentAdd task commentPOSTAdds a comment to an Asana task. Creates a story entry for team communication and progress updates.delete_storyDelete storyDELETEDeletes a comment from a task.get_stories_for_taskGet stories for taskGETLists all stories (activity and comments) on a task.get_storyGet storyGETRetrieves details of a specific story or comment.update_storyUpdate storyPUTUpdates a comment's text content.
Tag, 5 operations
create_tagCreate tagPOSTCreates a new workspace tag for task categorization.delete_tagDelete tagDELETEPermanently deletes a tag and removes it from all tasks.get_tagGet tagGETRetrieves details of a specific tag.get_tagsGet tagsGETLists all tags in a workspace for categorization and filtering options.update_tagUpdate tagPUTUpdates a tag's name, color, or description.
Webhook, 5 operations
create_webhookCreate webhookPOSTCreates a webhook subscription for resource change notifications.delete_webhookDelete webhookDELETEDeletes a webhook to stop receiving notifications.get_webhookGet webhookGETRetrieves details of a specific webhook.get_webhooksGet webhooksGETLists all webhooks for a workspace to manage event subscriptions.update_webhookUpdate webhookPUTUpdates a webhook's event filters.
Attachment, 4 operations
delete_attachmentDelete attachmentDELETEPermanently deletes a file attachment.get_attachmentGet attachmentGETRetrieves attachment details including download URL.get_attachments_for_taskGet attachments for taskGETLists all attachments on a task for file management and display.upload_attachmentUpload attachmentPOSTUploads a file (or attaches a URL) to a task, project, or project_brief.
Team, 4 operations
create_teamCreate teamPOSTCreates a new team in an organization.get_teamGet teamGETRetrieves details of a specific team.get_teams_for_workspaceGet teams for workspaceGETLists all teams in a workspace for team navigation and selection.update_teamUpdate teamPUTUpdates a team's name or description.
Dependency, 3 operations
add_task_dependenciesAdd task dependenciesPOSTAdds blocking tasks that must be completed before this task.get_task_dependenciesGet task dependenciesGETLists tasks that block this task (must be completed first).remove_task_dependenciesRemove task dependenciesPOSTRemoves blocking task relationships from this task.
User, 3 operations
get_meGet meGETRetrieves the authenticated user's profile information. Returns user GID, name, email, and workspaces for personalization and context.get_userGet userGETRetrieves details of a specific user.get_usersGet usersGETLists all users in an Asana workspace. Returns user names and GIDs for assignee selection and team member displays.
Workspace, 3 operations
get_workspaceGet workspaceGETRetrieves details of a specific workspace.get_workspacesGet workspacesGETLists all workspaces the authenticated user can access. Returns workspace names and GIDs for workspace selection and navigation.update_workspaceUpdate workspacePUTUpdates a workspace's name (admin only).
Enumoption, 2 operations
create_enum_optionCreate enum optionPOSTAdds a new option to an enum custom field dropdown.update_enum_optionUpdate enum optionPUTUpdates an enum option's name, color, or availability.
Subtask, 2 operations
create_subtaskCreate subtaskPOSTCreates a subtask under a parent task for breaking down work into smaller pieces.get_subtasksGet subtasksGETLists all subtasks of a parent task for displaying task hierarchies and breakdown structures.
Batch, 1 operation
batch_requestBatch requestPOSTExecutes multiple API requests in a single call for performance.
Dependent, 1 operation
get_task_dependentsGet task dependentsGETLists tasks that this task blocks (waiting for this task).
Event, 1 operation
get_eventsGet eventsGETPolls for resource changes using sync tokens for real-time updates.
Taskcount, 1 operation
get_project_task_countsGet project task countsGETReturns task count statistics for progress tracking and dashboards.
OAuth scopes Asana requires
Each operation declares the scopes Asana requires for it.
defaultneeded by add_followers_to_project, add_followers_to_task, add_members_to_project and 74 more
Use Asana from Claude Code, Cursor or Codex
Connect Asana in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Asana operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Asana
- Create your workspace
Sign up free. Nothing to install.
- Connect Asana once
Add your Asana connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Asana integration FAQ
What can you do with the Asana integration?
LiveContext exposes 77 operations on Asana, covering task, project, section and customfield. Common uses include workspace maintenance, tag cleanup and kanban boards.
Which OAuth scopes does Asana require?
The operations that declare a scope all need default.
