Skip to main content
Glama

MCP Server for Asana

Fork of roychri/mcp-server-asana with additional tools, read-only mode, and project management capabilities.

A Model Context Protocol (MCP) server that connects AI assistants to the Asana API for task, project, and workspace management.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}

Related MCP server: Asana MCP Server

Configuration

Variable

Required

Description

ASANA_ACCESS_TOKEN

Yes

Your Asana personal access token (generate one here)

READ_ONLY_MODE

No

Set to true to disable all write operations

Tools (33)

Workspaces

Tool

Description

asana_list_workspaces

List all available workspaces

Projects

Tool

Description

asana_search_projects

Search projects by name pattern

asana_get_project

Get project details

asana_get_project_task_counts

Get task counts for a project

asana_get_project_sections

Get sections in a project

asana_create_project

Create a new project

Project Status

Tool

Description

asana_get_project_status

Get a project status update

asana_get_project_statuses

List all status updates for a project

asana_create_project_status

Create a status update

asana_delete_project_status

Delete a status update

Tasks

Tool

Description

asana_search_tasks

Search tasks with advanced filtering

asana_get_task

Get task details

asana_create_task

Create a new task

asana_update_task

Update a task

asana_delete_task

Delete a task permanently

asana_create_subtask

Create a subtask

asana_get_multiple_tasks_by_gid

Get multiple tasks by GID (max 25)

asana_get_task_stories

Get comments and stories for a task

asana_create_task_story

Add a comment to a task

Task Relationships

Tool

Description

asana_add_task_dependencies

Set task dependencies

asana_add_task_dependents

Set task dependents

asana_set_parent_for_task

Set or change a task's parent

asana_add_project_to_task

Add a task to a project

asana_remove_project_from_task

Remove a task from a project

Tags

Tool

Description

asana_get_tag

Get tag details

asana_get_tags_for_task

Get tags on a task

asana_get_tasks_for_tag

Get tasks with a specific tag

asana_get_tags_for_workspace

List tags in a workspace

asana_create_tag_for_workspace

Create a tag

asana_update_tag

Update a tag

asana_delete_tag

Delete a tag

asana_add_tag_to_task

Add a tag to a task

asana_remove_tag_from_task

Remove a tag from a task

Prompts

Prompt

Description

task-summary

Generate a summary and status update for a task

task-completeness

Analyze if a task has sufficient details for completion

create-task

Create a task with guided details

Resources

Resource

URI Pattern

Description

Workspaces

asana://workspace/{gid}

Workspace details as JSON

Projects

asana://project/{gid}

Project details with sections and custom fields

Read-Only Mode

Set READ_ONLY_MODE=true to disable all write operations. Only read tools remain available, and the create-task prompt is hidden. Useful for testing or restricting access.

Contributing

Pull requests welcome. See the upstream project for the original implementation.

License

MIT License. See LICENSE for details.

Credits

Available Tools

33 tools
asana_add_project_to_taskB

Add an existing task to a project. If no positioning arguments are given, the task will be added to the end of the project.

Inputs: task_id (required), project_id (required), section, insert_after, +1 more.

asana_add_tag_to_taskC

Add a tag to a task

Inputs: tag_gid (required), task_gid (required).

asana_add_task_dependenciesC

Set dependencies for a task

Inputs: task_id (required), dependencies (required).

asana_add_task_dependentsB

Set dependents for a task (tasks that depend on this task)

Inputs: task_id (required), dependents (required).

asana_create_projectC

Create a new project in a workspace or team

Inputs: name (required), workspace (required), team, color, +4 more.

asana_create_project_statusB

Create a new status update for a project

Inputs: text (required), project_gid (required), color, title, +2 more.

asana_create_subtaskB

Create a new subtask for an existing task

Inputs: name (required), parent_task_id (required), notes, due_on, +3 more.

asana_create_tag_for_workspaceC

Create a new tag in a workspace

Inputs: name (required), workspace_gid (required), color, notes, +2 more.

asana_create_taskB

Create a new task in a project

Inputs: name (required), project_id (required), notes, due_on, +7 more.

asana_create_task_storyA

Create a comment or story on a task. Either text or html_text is required.

Inputs: task_id (required), text, html_text, opt_fields.

asana_delete_project_statusA

Delete a project status update

Inputs: project_status_gid (required).

asana_delete_tagC

Delete a tag

Inputs: tag_gid (required).

asana_delete_taskB

Delete a task. This permanently removes the task and cannot be undone.

Inputs: task_id (required).

asana_get_multiple_tasks_by_gidA

Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)

Inputs: task_ids (required), opt_fields.

asana_get_projectC

Get detailed information about a specific project

Inputs: project_id (required), opt_fields.

asana_get_project_sectionsB

Get sections in a project

Inputs: project_id (required), opt_fields.

asana_get_project_statusC

Get a project status update

Inputs: project_status_gid (required), opt_fields.

asana_get_project_statusesB

Get all status updates for a project

Inputs: project_gid (required), limit, offset, opt_fields.

asana_get_project_task_countsB

Get the number of tasks in a project

Inputs: project_id (required), opt_fields.

asana_get_tagC

Get detailed information about a specific tag

Inputs: tag_gid (required), opt_fields.

asana_get_tags_for_taskC

Get a task's tags

Inputs: task_gid (required), limit, offset, opt_fields.

asana_get_tags_for_workspaceA

Get tags in a workspace

Inputs: workspace_gid (required), limit, offset, opt_fields.

asana_get_taskB

Get detailed information about a specific task

Inputs: task_id (required), opt_fields.

asana_get_tasks_for_tagC

Get tasks for a specific tag

Inputs: tag_gid (required), limit, offset, opt_fields, +1 more.

asana_get_task_storiesB

Get comments and stories for a specific task

Inputs: task_id (required), opt_fields.

asana_list_workspacesB

List all available workspaces in Asana

Inputs: opt_fields.

asana_remove_project_from_taskA

Remove a task from a project. The task will still exist in the system, but it will not be in the project anymore.

Inputs: task_id (required), project_id (required).

asana_remove_tag_from_taskC

Remove a tag from a task

Inputs: tag_gid (required), task_gid (required).

asana_search_projectsA

Search for projects in Asana using name pattern matching

Inputs: workspace (required), name_pattern (required), archived, opt_fields.

asana_search_tasksB

Search tasks in a workspace with advanced filtering options

Inputs: workspace (required), text, due_on, sort_by, +51 more.

asana_set_parent_for_taskA

Set the parent of a task and position the subtask within the other subtasks of that parent

Inputs: data (required), task_id (required), opts.

asana_update_tagC

Update an existing tag

Inputs: tag_gid (required), name, color, notes, +1 more.

asana_update_taskC

Update an existing task's details

Inputs: task_id (required), name, notes, due_on, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 33 tools

    Disambiguation4/5

    Most tools target a distinct resource+action, but there are a few confusable pairs: asana_add_task_dependencies vs asana_add_task_dependents, and the singular/plural asana_get_project_status vs asana_get_project_statuses. asana_set_parent_for_task and asana_create_subtask also overlap conceptually around parent/subtask relationships, though descriptions help distinguish them.

    Naming Consistency5/5

    Every tool follows a consistent asana_verb_noun pattern (e.g. asana_get_task, asana_create_tag_for_workspace, asana_add_tag_to_task). Prefix, verb style, and snake_case are uniform throughout, making the surface highly predictable.

    Tool Count3/5

    33 tools is on the heavy end, exceeding the comfortable 3-15 range and bordering on the 25+ 'too many' threshold. Asana is a broad domain that justifies much of this breadth, but some consolidation (e.g. tags/stories) would reduce surface area.

    Completeness4/5

    Strong lifecycle coverage: task CRUD plus stories, subtasks, dependencies, project associations, tags, and project statuses. Minor gaps exist (no update_project, no delete_project, no update_project_status), but core workflows are well supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers