mcp-server-asana
Provides tools for managing Asana workspaces, projects, tasks, tags, and project statuses, including CRUD operations and advanced search, enabling AI agents to interact with the Asana platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-asana list my tasks in the Marketing project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Yes | Your Asana personal access token (generate one here) |
| No | Set to |
Tools (33)
Workspaces
Tool | Description |
| List all available workspaces |
Projects
Tool | Description |
| Search projects by name pattern |
| Get project details |
| Get task counts for a project |
| Get sections in a project |
| Create a new project |
Project Status
Tool | Description |
| Get a project status update |
| List all status updates for a project |
| Create a status update |
| Delete a status update |
Tasks
Tool | Description |
| Search tasks with advanced filtering |
| Get task details |
| Create a new task |
| Update a task |
| Delete a task permanently |
| Create a subtask |
| Get multiple tasks by GID (max 25) |
| Get comments and stories for a task |
| Add a comment to a task |
Task Relationships
Tool | Description |
| Set task dependencies |
| Set task dependents |
| Set or change a task's parent |
| Add a task to a project |
| Remove a task from a project |
Tags
Tool | Description |
| Get tag details |
| Get tags on a task |
| Get tasks with a specific tag |
| List tags in a workspace |
| Create a tag |
| Update a tag |
| Delete a tag |
| Add a tag to a task |
| Remove a tag from a task |
Prompts
Prompt | Description |
| Generate a summary and status update for a task |
| Analyze if a task has sufficient details for completion |
| Create a task with guided details |
Resources
Resource | URI Pattern | Description |
Workspaces |
| Workspace details as JSON |
Projects |
| 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
Available Tools
33 toolsasana_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
Scored across 33 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) server that enables interacting with the Asana API through natural language commands for task management, project organization, and team collaboration.-
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Asana API, auto-generated using AG2's MCP builder.-
- FlicenseNot gradedqualityDmaintenanceA Type 4 OAuth MCP server for the Asana API, enabling AI assistants to manage workspaces, projects, tasks, comments, users, and teams.-
- FlicenseNot gradedqualityFmaintenanceA Model Context Protocol (MCP) server that provides AI assistants full access to the Motion task and project management API, enabling task, project, and schedule management.-