Asana MCP Server
Asana tasks, projects, and workspaces access for your AI assistant.
Data last scanned yesterday · Reviewed 2 months ago
Overview
This implementation enables AI assistants to interact directly with the Asana API. It allows users to perform operations such as searching for projects within specific workspaces, listing available workspaces, and querying tasks using various filters like completion status, subtasks, or blocking dependencies. The server supports configuration via environment variables, including an optional read-only mode to prevent unintended modifications to workspace data. It is designed to work with standard MCP clients, including the Claude Desktop application.
Our verdict
With a high-risk security score of 30/100, this server should be used with caution. The primary concern is the lack of a dedicated authentication method, meaning anyone with access to the configuration can utilize the server. Additionally, it is a community-maintained project rather than an official vendor tool, and it has not undergone editorial review. Users should prioritize enabling the read-only mode to mitigate risks associated with write operations.
- Includes an optional read-only mode to restrict write access
- Small dependency footprint with only three direct dependencies
- Documented support for advanced task filtering options
- Lacks native authentication mechanisms for protected access
- Community-maintained rather than supported by the official vendor
- No official homepage link provided
Setup
{
"mcpServers": {
"mcp-server-asana": {
"args": [
"-y",
"@roychri/mcp-server-asana"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| asana_list_workspaces | List all available workspaces in Asana | low |
| asana_search_projects | Search for projects in Asana using name pattern matching | low |
| asana_search_tasks | Search tasks in a workspace with advanced filtering options | low |
| asana_get_task | Get detailed information about a specific task | low |
| asana_create_task | Create a new task in a project | medium |
| asana_get_task_stories | Get comments and stories for a specific task | low |
| asana_update_task | Update an existing task's details | medium |
| asana_get_project | Get detailed information about a specific project | low |
| asana_get_project_task_counts | Get the number of tasks in a project | low |
| asana_get_project_sections | Get sections in a project | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What configuration is required to run the Asana MCP server?
You must provide an ASANA_ACCESS_TOKEN via an environment variable to authorize the server.
›Can I prevent the MCP server from modifying my Asana data?
Yes, you can set the READ_ONLY_MODE environment variable to 'true' to disable all create, update, and delete operations.
›How can I improve the chances of the LLM selecting the right Asana tool?
Mentioning the word 'asana' in your prompt will help the AI identify that it should use the Asana tools.
›Does the server support filtering tasks by their status or attributes?
Yes, the asana_search_tasks tool supports various filters including completed status, resource subtype, subtask status, and attachment presence.
Alternatives
Badge
Maintain this server? Add the live badge to your README.