← Back to directory

Asana MCP Server

Community

Connect Asana with MCP to manage tasks, projects, comments, and tags.

GitHub source repository ↗

★ 147 Stars Category · Collaboration Popular Source revision c4508aac54e2

41FMRS · D

Reliability

4/20

Security and permissions

7/20

Maintenance

5/20

Documentation

12/20

Setup experience

13/20

This MCP server offers comprehensive Asana integration covering tasks, projects, tags, sections, and more, suitable for various clients. Setup is straightforward, but attention must be paid to token security and the risk of accidental modifications.

Read the FMRS scoring method →

This MCP server acts as a bridge to the Asana API, allowing MCP clients (such as Anthropic's Claude Desktop) to interact with the user's Asana workspace. It provides 41 tools, 3 prompts, and 2 resources covering core project management features: workspaces, projects, tasks, subtasks, sections, tags, comments, status updates, and more.

Tools

asana_list_workspaces

List all available Asana workspaces in the workspace.

asana_search_projects

Search for projects by name pattern.

asana_search_tasks

Search tasks in a workspace with advanced filtering.

asana_get_task

Get detailed information about a specific task.

asana_create_task

Create a new task in a project.

asana_get_task_stories

Get comments and stories for a task.

asana_update_task

Update an existing task's details.

asana_get_project

Get detailed information about a project.

asana_get_project_task_counts

Get the number of tasks in a project.

asana_get_project_sections

Get sections in a project.

asana_create_task_story

Create a comment or story on a task.

asana_add_task_dependencies

Set dependencies for a task.

asana_add_task_dependents

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

asana_create_subtask

Create a new subtask for an existing task.

asana_get_multiple_tasks_by_gid

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

asana_get_project_status

Get a project status update.

asana_get_project_statuses

Get all status updates for a project.

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 the parent of a task and position it among other subtasks.

asana_get_tag

Get detailed information about a specific tag.

asana_get_tags_for_task

Get a task's tags.

asana_get_tasks_for_tag

Get tasks for a specific tag.

asana_get_tags_for_workspace

Get tags in a workspace.

asana_update_tag

Update an existing tag.

asana_delete_tag

Delete a tag.

asana_create_tag_for_workspace

Create a new tag in a workspace.

asana_add_tag_to_task

Add a tag to a task.

asana_remove_tag_from_task

Remove a tag from a task.

asana_add_project_to_task

Add an existing task to a project.

asana_remove_project_from_task

Remove a task from a project.

asana_delete_task

Delete a task permanently.

asana_create_project

Create a new project in a workspace or team.

asana_update_project

Update a project's details (name, description, etc.).

asana_create_section

Create a new section in a project.

asana_update_section

Update a section (rename).

asana_delete_section

Delete a section from a project.

asana_add_task_to_section

Move a task to a section within its project.

asana_get_subtasks

Get all subtasks of a given task.

asana_get_tasks_for_project

Get all tasks in a project (works on free Asana plans).

asana_get_my_tasks

Get tasks from the authenticated user's 'My Tasks' list.

Setup

Create an Asana account: visit https://www.asana.com and sign up.
Get an access token: generate a personal access token at the Asana developer console (https://app.asana.com/0/my-apps). See https://developers.asana.com/docs/personal-access-token.
Configure your client:

- For Claude Desktop, add the configuration to claude_desktop_config.json.
- For Claude Code, run: claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana.
- For Codex CLI, add the configuration to ~/.codex/config.toml.

claude_desktop_config.json

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

Generate and validate client config

Fit and risk

Best for

Teams that want to integrate Asana into their AI assistant workflow to operate tasks and projects via natural language.
Developers and project managers who need quick access to and modification of Asana data.
Teams that want to unify multiple tools via the MCP protocol.

Not for

Users who do not need to interact with Asana.
Organizations highly sensitive about data privacy who are uncomfortable with Asana data being processed by third-party servers (though this server runs locally).
Scenarios requiring advanced admin privileges (e.g., user management, workspace settings) not supported by this server.

Required permissions

Requires ASANA_ACCESS_TOKEN environment variable with read/write permissions to Asana API (depending on token scope).
When READ_ONLY_MODE=true, all write operations are disabled.

Risks and side effects

Token leakage risk: if the access token is leaked, an attacker may read or modify Asana data. Store the token securely.
Accidental modifications: AI might execute delete or update operations unintentionally. It is recommended to test in a sandbox or enable READ_ONLY_MODE.
Data privacy: the server is only a bridge, but Asana data will be processed by the MCP client; consider the client's data handling.

Troubleshooting

Verify that ASANA_ACCESS_TOKEN is set correctly and has the necessary permissions.
Ensure your Asana plan allows API access (some features like search_tasks may require a premium plan).
Check the client configuration file (e.g., claude_desktop_config.json) for correct format and path.
Review error logs for permission errors or network issues.

Use cases

Query unfinished tasks, filter tasks by project or tag, get task details.

Create tasks, subtasks, add comments, update task status.

Manage projects, sections, tags, and project status.

Supported clients

Claude DesktopFull support

Claude CodeFull support

Codex CLIFull support

Related MCP servers

Compare with other MCP servers