Asana MCP Server

How to use

Start the MCP server for Asana using a standard CLI that launches a local process you can connect to from your MCP client. In your client configuration, reference the server under the mcpServers section. When you ask questions related to Asana—such as tasks, projects, workspaces, or comments—mention the word asana to help guide the client to use the Asana MCP server.

How to install

Prerequisites you need before installation:

• Node.js and npm should be installed on your system
• Access to Asana with a personal access token

Install and run the MCP server using the following commands. These commands mirror the configuration shown for Claude Desktop integration.

# Install the MCP server package via npm
npm install -g @cristip73/mcp-server-asana

# Alternatively, run via npx when you start the server

Additional configuration and usage notes

Configure your MCP client to connect to the Asana MCP server. You typically provide the following environment variables when starting or configuring your client integration:

ASANA_ACCESS_TOKEN=your-asana-access-token
DEFAULT_WORKSPACE_ID=your-default-workspace-id

asana_list_workspaces

List all available workspaces in Asana, with optional fields and a default workspace handling.

asana_search_projects

Search for projects using name pattern matching with optional workspace, team, and pagination controls.

asana_search_tasks

Search tasks within a workspace using text filtering and a rich set of optional filters like assignee, projects, sections, tags, and more.

asana_get_task

Retrieve detailed information for a specific task with optional fields.

asana_create_task

Create a new task in a project with optional notes, due date, assignee, followers, and custom fields.

asana_get_task_stories

Get comments and stories attached to a specific task.

asana_update_task

Update a task’s details including name, notes, due date, assignee, completion status, and custom fields.

asana_get_project

Get detailed information about a specific project with optional fields.

asana_get_project_task_counts

Get the number of tasks in a project with optional fields.

asana_get_project_sections

List sections within a project.

asana_create_task_story

Create a comment or story on a task.

asana_add_task_dependencies

Define dependencies for a task.

asana_add_task_dependents

Define dependents for a task.

asana_create_subtask

Create a new subtask under an existing task.

asana_add_followers_to_task

Add followers to a task.

asana_get_multiple_tasks_by_gid

Fetch detailed information for multiple tasks by their GIDs (up to 25).

asana_get_project_status

Retrieve a project status update by GID.

asana_get_project_statuses

Get all status updates for a project with pagination.

asana_create_project_status

Create a new status update for a project.

asana_delete_project_status

Delete a project status update.

asana_set_parent_for_task

Set or change the parent of a task and position within subtasks.

asana_get_tasks_for_tag

List tasks associated with a specific tag.

asana_get_tags_for_workspace

List tags within a workspace.

asana_create_section_for_project

Create a new section in a project.

asana_add_task_to_section

Move or assign a task to a specific section within a project.

asana_create_project

Create a new project within a workspace.

asana_get_teams_for_user

List teams accessible to a specific user.

asana_get_teams_for_workspace

List teams within a workspace.

asana_list_workspace_users

List users in a workspace with optional fields and pagination.

asana_get_project_hierarchy

Get the complete hierarchical structure of a project including sections and tasks.

asana_get_attachments_for_object

List attachments for a specific object like a task or project.

asana_upload_attachment_for_object

Upload a local file as an attachment to an object.

asana_download_attachment

Download an attachment to a local directory.