M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
A

Asana MCP Server

Community
Connect Asana with MCP to manage tasks, projects, comments, and tags.
How to install ↓ Compare GitHub source repository ↗
Category
Collaboration #46 of 55
Stars
★ 148 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
License
MIT
Last commit
Tools
41
41FMRS · D

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.

Strongest · Setup experience 13/20 Weakest · Reliability 4/20

Reliability
4/20
Security and permissions
7/20
Maintenance
5/20
Documentation
12/20
Setup experience
13/20
Why each score
Reliability 4/20
Only the README and repository metadata were supplied; no source code, server manifest, CI, or tests are available. The 41 tools and 3 prompts in the README cannot be cross-checked against real behavior, and the MCP init and tool-list handshake cannot be verified. There is no obvious contradiction in the README, so the score is not zero, but the complete absence of executable evidence forces a low score.
Security and permissions 7/20
No red-line issues such as malware, embedded secrets, or unconditional destructive defaults are apparent. The token is passed via an environment variable, and READ_ONLY_MODE is documented to disable write operations. However, enforcement cannot be verified from source, no least-privilege token scopes are documented, and destructive tools (delete task/status/tag/section) show no confirmation flow. Main risks are visible, but least privilege and confirmation mechanisms are incomplete.
Maintenance 5/20
The repository is not archived and has an MIT license, so it is not abandoned. However, there is no evidence of commit history, release timelines, issue-response behavior, or dependency updates. Maintenance activity and governance cannot be verified, so the score is conservatively mid-low.
Documentation 12/20
The README covers environment variables, parameters for 41 tools, 3 prompts, 2 resource types, setup examples for three clients, and basic troubleshooting. It also discloses some limits (pagination 1-100, max 25 tasks, premium-only search). But cost/rate-limit information, real response examples, and deeper limitation disclosures are missing. The README is untrusted evidence without source-backed verification, so documentation is usable but incomplete.
Setup experience 13/20
The README clearly describes creating an Asana account, obtaining a token, and pasting config examples for Claude Desktop, Claude Code, or Codex CLI, all in few steps. However, no source, CI, or committed tests prove the npx package actually runs, and no pinned version or Node.js requirement is given. The static calibration caps setup at 15 without execution evidence, and manual configuration is still required, so 13 is awarded.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

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.

Setup

Before you start

Runtime：Node.js

ASANA_ACCESS_TOKEN requiredsecret Required Asana personal access token, generated from the Asana developer console at https://app.asana.com/0/my-apps.
Other optional settings (1)
READ_ONLY_MODE optional Optional; set to 'true' to disable all write operations and expose only read-only tools, useful for testing or safety.
  1. Create an Asana account: visit https://www.asana.com and sign up.
  2. 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.
  3. 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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add asana -e ASANA_ACCESS_TOKEN=your-asana-access-token -- npx -y @roychri/mcp-server-asana

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After adding the server to your client config and restarting, tools like asana_list_workspaces should appear in the client's tool list; calling asana_list_workspaces and getting your workspaces back confirms the connection works.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

  • How many unfinished asana tasks do we have in our Sprint 30 project?
  • Search my asana workspace for projects with names matching 'Sprint'
  • Get all comments on an asana task
  • Create a new asana task named 'Weekly report' in my workspace

Tools 41

asana_list_workspaces read-only
List all available Asana workspaces in the workspace.
asana_search_projects read-only
Search for projects by name pattern.
asana_search_tasks read-only
Search tasks in a workspace with advanced filtering.
asana_get_task read-only
Get detailed information about a specific task.
asana_create_task writes
Create a new task in a project.
asana_get_task_stories read-only
Get comments and stories for a task.
asana_update_task writes
Update an existing task's details.
asana_get_project read-only
Get detailed information about a project.
Show 33 more tools
asana_get_project_task_counts read-only
Get the number of tasks in a project.
asana_get_project_sections read-only
Get sections in a project.
asana_create_task_story writes
Create a comment or story on a task.
asana_add_task_dependencies writes
Set dependencies for a task.
asana_add_task_dependents writes
Set dependents for a task (tasks that depend on this task).
asana_create_subtask writes
Create a new subtask for an existing task.
asana_get_multiple_tasks_by_gid read-only
Get detailed information about multiple tasks by their GIDs (max 25).
asana_get_project_status read-only
Get a project status update.
asana_get_project_statuses read-only
Get all status updates for a project.
asana_create_project_status writes
Create a new status update for a project.
asana_delete_project_status destructive
Delete a project status update.
asana_set_parent_for_task writes
Set the parent of a task and position it among other subtasks.
asana_get_tag read-only
Get detailed information about a specific tag.
asana_get_tags_for_task read-only
Get a task's tags.
asana_get_tasks_for_tag read-only
Get tasks for a specific tag.
asana_get_tags_for_workspace read-only
Get tags in a workspace.
asana_update_tag writes
Update an existing tag.
asana_delete_tag destructive
Delete a tag.
asana_create_tag_for_workspace writes
Create a new tag in a workspace.
asana_add_tag_to_task writes
Add a tag to a task.
asana_remove_tag_from_task writes
Remove a tag from a task.
asana_add_project_to_task writes
Add an existing task to a project.
asana_remove_project_from_task writes
Remove a task from a project.
asana_delete_task destructive
Delete a task permanently.
asana_create_project writes
Create a new project in a workspace or team.
asana_update_project writes
Update a project's details (name, description, etc.).
asana_create_section writes
Create a new section in a project.
asana_update_section writes
Update a section (rename).
asana_delete_section destructive
Delete a section from a project.
asana_add_task_to_section writes
Move a task to a section within its project.
asana_get_subtasks read-only
Get all subtasks of a given task.
asana_get_tasks_for_project read-only
Get all tasks in a project (works on free Asana plans).
asana_get_my_tasks read-only
Get tasks from the authenticated user's 'My Tasks' list.

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 Desktop
Claude Code
Codex

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Compare with other MCP servers

Source revision c4508aac54e2 Data synced 2026-10-12 Read the FMRS scoring method