asana_add_project_to_task
Add an existing task to a project. If no positioning arguments are given, the task will be added to the end of the project.
LABSCO SUMMARY
Asana's search grammar becomes something you can ask for in a sentence.
asana_search_tasks is the centre of this set: blocked and blocking, section and portfolio membership, five different date axes, all in one call, which turns questions that need a saved search in the UI into a single request. The writes are structured rather than cosmetic — subtasks, dependencies both ways, re-parenting, and section moves that respect position. It is one token's view of Asana, so whatever that token cannot see does not exist here, and deletion of tasks, tags and sections sits in the same set as the reads.
What it is
A server over the Asana API scoped to one access token's workspaces — tasks, subtasks, dependencies, projects, sections, tags and project status updates in 41 tools.
What you get
- asana_search_tasks carrying Asana's filter language nearly whole: assignee, creator, project, section, tag, team and portfolio membership, is_blocked and is_blocking, has_attachment, and created, modified, due, start and completed windows in both date and datetime form
- Task structure written rather than only read — asana_create_subtask, re-parenting through asana_set_parent_for_task, and dependencies in both directions with asana_add_task_dependencies and asana_add_task_dependents
- Batched reads: asana_get_multiple_tasks_by_gid fetches up to 25 tasks in one call
- Project status updates as first-class objects with a colour, listable, creatable and deletable
- Membership as positioned moves — a task added to a project or a section with insert_before or insert_after, or removed from a project without being deleted
- Tags created at workspace level, attached and detached per task, and used as a query axis through asana_get_tasks_for_tag
- opt_fields on nearly every read, so a response can be trimmed to the fields the answer actually needs
Requirements
ASANA_ACCESS_TOKEN, and an Asana account whose workspaces that token can reach — asana_list_workspaces is the entry point to everything else. The write surface includes asana_delete_task, which the tool itself describes as permanent and not undoable.
Setup effort
One command plus a key — npx -y @roychri/mcp-server-asana, then supply credentials
USE CASES
01
Finding what is blocked before standup
Search the workspace for incomplete tasks that are blocked or blocking, open the ones that matter, and read the comment history to see who is waiting on whom.
02
Breaking a large task into a plan
Create the subtasks under the parent, read them back to confirm the shape, then set which ones block which so the order is expressed in Asana rather than in a comment.
03
Filing this week's project status
Get the task counts behind the claim first, post the status update with a colour that matches it, and read the previous updates so the wording follows on from the last one.
04
Triaging your own My Tasks list
Pull the personal task list for the workspace, update due dates and assignees on what has moved, and drop each task into the section it now belongs in.
05
Standing up a project from scratch
Create the project in the right team, add the sections it will be organised by, then create the first tasks and attach any existing ones that belong to it.
06
Cleaning up tag sprawl in a workspace
List the workspace's tags, see what each one is actually attached to, detach the ones that were applied by mistake, and delete the tags that no longer carry meaning.
41 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
asana_add_tag_to_task
Add a tag to 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_add_task_to_section
Move a task to a section within its project
asana_create_project
Create a new project in a workspace or team
asana_create_project_status
Create a new status update for a project
asana_create_section
Create a new section in a project
asana_create_subtask
Create a new subtask for an existing task
asana_create_tag_for_workspace
Create a new tag in a workspace
asana_create_task
Create a new task in a project
asana_create_task_story
Create a comment or story on a task. Either text or html_text is required.
asana_delete_project_status
Delete a project status update
asana_delete_section
Delete a section from a project
asana_delete_tag
Delete a tag
asana_delete_task
Delete a task. This permanently removes the task and cannot be undone.
asana_get_multiple_tasks_by_gid
Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)
asana_get_my_tasks
Get tasks from the authenticated user's 'My Tasks' list in a workspace. Returns the user's personal task list including sections like Inbox, Today, This Week, etc.
asana_get_project
Get detailed information about a specific project
asana_get_project_sections
Get sections in a project
asana_get_project_status
Get a project status update
asana_get_project_statuses
Get all status updates for a project
asana_get_project_task_counts
Get the number of tasks in a project
asana_get_subtasks
Get all subtasks of a given task. Returns a compact representation of each subtask.
asana_get_tag
Get detailed information about a specific tag
asana_get_tags_for_task
Get a task's tags
asana_get_tags_for_workspace
Get tags in a workspace
asana_get_task
Get detailed information about a specific task
asana_get_task_stories
Get comments and stories for a specific task
asana_get_tasks_for_project
Get all tasks in a project. Use this instead of search_tasks when you need to list tasks in a specific project. Supports pagination and optional field selection.
asana_get_tasks_for_tag
Get tasks for a specific tag
asana_list_workspaces
List all available workspaces in Asana
asana_remove_project_from_task
Remove a task from a project. The task will still exist in the system, but it will not be in the project anymore.
asana_remove_tag_from_task
Remove a tag from a task
asana_search_projects
Search for projects in Asana using name pattern matching
asana_search_tasks
Search tasks in a workspace with advanced filtering options
asana_set_parent_for_task
Set the parent of a task and position the subtask within the other subtasks of that parent
asana_update_project
Update a project's details (name, description, etc.)
asana_update_section
Update a section (rename it)
asana_update_tag
Update an existing tag
asana_update_task
Update an existing task's details
BEFORE YOU INSTALL
What to know first
Tools you get
41 tools when we connected. Setting READ_ONLY_MODE to true disables every create, update and delete tool, leaving reads only.
Requires
- npx on PATH
- ASANA_ACCESS_TOKEN in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 41 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @roychri/mcp-server-asanaMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"asana": {
"command": "npx",
"args": [
"-y",
"@roychri/mcp-server-asana"
],
"env": {
"ASANA_ACCESS_TOKEN": "<YOUR_ASANA_ACCESS_TOKEN>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add asana -e ASANA_ACCESS_TOKEN=<YOUR_ASANA_ACCESS_TOKEN> -- npx -y @roychri/mcp-server-asanaCodex
CODEX · TOML
[mcp_servers.asana]
command = "npx"
args = ["-y", "@roychri/mcp-server-asana"]
[mcp_servers.asana.env]
ASANA_ACCESS_TOKEN = "<YOUR_ASANA_ACCESS_TOKEN>"
