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"
}
}
}
}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
- Original implementation by Christian Roy
- Fork maintained by 84em.io
