roychri/mcp-server-asana

This Model Context Protocol server implementation of Asana allows you
to talk to Asana API from MCP Client such as Anthropic's Claude
Desktop Application, and many more.
More details on MCP here:
- https://www.anthropic.com/news/model-context-protocol
- https://modelcontextprotocol.io/introduction
- https://github.com/modelcontextprotocol
Environment Variables
- ASANA_ACCESS_TOKEN: (Required) Your Asana access token
- READ_ONLY_MODE: (Optional) Set to 'true' to disable all write operations. In this mode:
- Tools that modify Asana data (create, update, delete) will be disabled
- The create-task prompt will be disabled
- Only read operations will be available
This is useful for testing or when you want to ensure no changes can be made to your Asana workspace.
Usage
In the AI tool of your choice (ex: Claude Desktop) ask something about asana tasks, projects, workspaces, and/or comments. Mentioning the word "asana" will increase the chance of having the LLM pick the right tool.
Example:
> How many unfinished asana tasks do we have in our Sprint 30 project?
Another example:
Tools
1. asana_list_workspaces
* List all available workspaces in Asana
* Optional input:
* opt_fields (string): Comma-separated list of optional fields to include
* Returns: List of workspaces
2. asana_search_projects
* Search for projects in Asana using name pattern matching
* Required input:
* workspace (string): The workspace to search in
* name_pattern (string): Regular expression pattern to match project names
* Optional input:
* archived (boolean): Only return archived projects (default: false)
* opt_fields (string): Comma-separated list of optional fields to include
* Returns: List of matching projects
3. asana_search_tasks
* Search tasks in a workspace with advanced filtering options
* Required input:
* workspace (string): The workspace to search in
* Optional input:
* text (string): Text to search for in task names and descriptions
* resource_subtype (string): Filter by task subtype (e.g. milestone)
* completed (boolean): Filter for completed tasks
* is_subtask (boolean): Filter for subtasks
* has_attachment (boolean): Filter for tasks with attachments
* is_blocked (boolean): Filter for tasks with incomplete dependencies
* is_blocking (boolean): Filter for incomplete tasks with dependents
* assignee, projects, sections, tags, teams, and many other advanced filters
* sort_by (string): Sort by due_date, created_at, completed_at, likes, modified_at (default: modified_at)
* sort_ascending (boolean): Sort in ascending order (default: false)
* opt_fields (string): Comma-separated list of optional fields to include
* custom_fields (object): Object containing custom field filters
* Returns: List of matching tasks
4. asana_get_task
* Get detailed information about a specific task
* Required input:
* task_id (string): The task ID to retrieve
* Optional input:
* opt_fields (string): Comma-separated list of optional fields to include
* Returns: Detailed task information
5. asana_create_task
* Create a new task in a project
* Required input:
* project_id (string): The project to create the task in
* name (string): Name of the task
* Optional input:
* notes (string): Description of the task
* html_notes (string): HTML-like formatted description of the task
* due_on (string): Due date in YYYY-MM-DD format
* assignee (string): Assignee (can be 'me' or a user ID)
* followers (array of strings): Array of user IDs to add as followers
* parent (string): The parent task ID to set this task under
* projects (array of strings): Array of project IDs to add this task to
* resource_subtype (string): The type of the task (default_task or milestone)
* custom_fields (object): Object mapping custom field GID strings to their values
* Returns: Created task information
6. asana_get_task_stories
* Get comments and stories for a specific task
* Required input:
* task_id (string): The task ID to get stories for
* Optional input:
* opt_fields (string): Comma-separated list of optional fields to include
* Returns: List of task stories/comments
7. asana_update_task
* Update an existing task's details
* Required input:
* task_id (string): The task ID to update
* Optional input:
* name (string): New name for the task
* notes (string): New description for the task
* html_notes (string): HTML-like formatted description of the task (subset of HTML tags supported)
* due_on (string): New due date in YYYY-MM-DD format
* assignee (string): New assignee (can be 'me' or a user ID)
* followers (array): Array of user IDs to add as followers