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.

- https://www.anthropic.com/news/model-context-protocol
- https://modelcontextprotocol.io/introduction
- https://github.com/modelcontextprotocol

asana_update_task({ task_id: "TASK_ID", custom_fields: { "custom_field_gid": value // The value format depends on the field type } })

asana_get_task({ task_id: "TASK_ID", opt_fields: "custom_fields,custom_fields.enum_options" })

// First, get the task with custom fields const taskDetails = asana_get_task({ task_id: "1234567890", opt_fields: "custom_fields,custom_fields.enum_options" }); // Find the custom field GID and enum option GID const priorityFieldGid = "11112222"; // From taskDetails.custom_fields const highPriorityOptionGid = "33334444"; // From the enum_options of the priority field // Update the task with the custom field asana_update_task({ task_id: "1234567890", custom_fields: { [priorityFieldGid]: highPriorityOptionGid } });

- List all available workspaces in Asana
- Optional input:

- opt_fields (string): Comma-separated list of optional fields to include

- Search for projects in Asana using name pattern matching
- Required input:

- name_pattern (string): Regular expression pattern to match project names

- workspace (string): The workspace to search in (optional if DEFAULT_WORKSPACE_ID is set)
- team (string): The team to filter projects on
- archived (boolean): Only return archived projects (default: false)
- limit (number): Results per page (1-100)
- offset (string): Pagination offset token
- opt_fields (string): Comma-separated list of optional fields to include

- Search tasks in a workspace with advanced filtering options
- Required input:

- workspace (string): The workspace to search in (optional if DEFAULT_WORKSPACE_ID is set)

- 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

- Get detailed information about a specific task
- Required input:

- task_id (string): The task ID to retrieve

- opt_fields (string): Comma-separated list of optional fields to include

- 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

- 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

- Get comments and stories for a specific task
- Required input:

- task_id (string): The task ID to get stories for

- opt_fields (string): Comma-separated list of optional fields to include

- Update an existing task's details
- Required input:

- task_id (string): The task ID to update

- name (string): New name for the task
- notes (string): New description for the task
- due_on (string): New due date in YYYY-MM-DD format
- assignee (string): New assignee (can be 'me' or a user ID)
- completed (boolean): Mark task as completed or not
- resource_subtype (string): The type of the task (default_task or milestone)
- custom_fields (object): Object mapping custom field GID strings to their values

- Get detailed information about a specific project
- Required input:

- project_id (string): The project ID to retrieve

- opt_fields (string): Comma-separated list of optional fields to include

- Get the number of tasks in a project
- Required input:

- project_id (string): The project ID to get task counts for

- opt_fields (string): Comma-separated list of optional fields to include

- Get sections in a project
- Required input:

- project_id (string): The project ID to get sections for

- opt_fields (string): Comma-separated list of optional fields to include

- Create a comment or story on a task
- Required input:

- task_id (string): The task ID to add the story to
- text (string): The text content of the story/comment

- opt_fields (string): Comma-separated list of optional fields to include

- Set dependencies for a task
- Required input:

- task_id (string): The task ID to add dependencies to
- dependencies (array of strings): Array of task IDs that this task depends on

- Set dependents for a task (tasks that depend on this task)
- Required input:

- task_id (string): The task ID to add dependents to
- dependents (array of strings): Array of task IDs that depend on this task

- Create a new subtask for an existing task
- Required input:

- parent_task_id (string): The parent task ID to create the subtask under
- name (string): Name of the subtask

- notes (string): Description of the subtask
- due_on (string): Due date in YYYY-MM-DD format
- assignee (string): Assignee (can be 'me' or a user ID)
- opt_fields (string): Comma-separated list of optional fields to include

- Add followers to a task
- Required input:

- task_id (string): The task ID to add followers to
- followers (array of strings): Array of user IDs to add as followers to the task

- Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)
- Required input:

- task_ids (array of strings or comma-separated string): Task GIDs to retrieve (max 25)

- opt_fields (string): Comma-separated list of optional fields to include

- Get a project status update
- Required input:

- project_status_gid (string): The project status GID to retrieve

- opt_fields (string): Comma-separated list of optional fields to include

- Get all status updates for a project
- Required input:

- project_gid (string): The project GID to get statuses for

- limit (number): Results per page (1-100)
- offset (string): Pagination offset token
- opt_fields (string): Comma-separated list of optional fields to include

- Create a new status update for a project
- Required input:

- project_gid (string): The project GID to create the status for
- text (string): The text content of the status update

- color (string): The color of the status (green, yellow, red)
- title (string): The title of the status update
- html_text (string): HTML formatted text for the status update
- opt_fields (string): Comma-separated list of optional fields to include

- Delete a project status update
- Required input:

- project_status_gid (string): The project status GID to delete

- Set the parent of a task and position the subtask within the other subtasks of that parent
- Required input:

- task_id (string): The task ID to operate on
- parent (string): The new parent of the task, or null for no parent

- insert_after (string): A subtask of the parent to insert the task after, or null to insert at the beginning of the list
- insert_before (string): A subtask of the parent to insert the task before, or null to insert at the end of the list
- opt_fields (string): Comma-separated list of optional fields to include

- Get tasks for a specific tag
- Required input:

- tag_gid (string): The tag GID to retrieve tasks for

- opt_fields (string): Comma-separated list of optional fields to include
- opt_pretty (boolean): Provides the response in a 'pretty' format
- limit (integer): The number of objects to return per page. The value must be between 1 and 100.
- offset (string): An offset to the next page returned by the API.

- Get tags in a workspace
- Required input:

- workspace_gid (string): Globally unique identifier for the workspace or organization (optional if DEFAULT_WORKSPACE_ID is set)

- limit (integer): Results per page. The number of objects to return per page. The value must be between 1 and 100.
- offset (string): Offset token. An offset to the next page returned by the API.
- opt_fields (string): Comma-separated list of optional fields to include

- Create a new section in a project
- Required input:

- project_id (string): The project ID to create the section in
- name (string): Name of the section to create

- opt_fields (string): Comma-separated list of optional fields to include

- Add a task to a specific section in a project
- Required input:

- section_id (string): The section ID to add the task to
- task_id (string): The task ID to add to the section

- opt_fields (string): Comma-separated list of optional fields to include

- Create a new project in a workspace
- Required input:

- workspace_id (string): The workspace ID to create the project in (optional if DEFAULT_WORKSPACE_ID is set)
- name (string): Name of the project to create
- team_id (string): REQUIRED for organization workspaces - The team GID to share the project with

- public (boolean): Whether the project is public to the organization (default: false)
- archived (boolean): Whether the project is archived (default: false)
- color (string): Color of the project (light-green, light-orange, light-blue, etc.)
- layout (string): The layout of the project (board, list, timeline, or calendar)
- default_view (string): The default view of the project (list, board, calendar, timeline, or gantt)
- due_on (string): The date on which this project is due (YYYY-MM-DD format)
- start_on (string): The day on which work for this project begins (YYYY-MM-DD format)
- notes (string): Free-form textual information associated with the project
- opt_fields (string): Comma-separated list of optional fields to include

- Get teams to which the user has access
- Required input:

- user_gid (string): The user GID to get teams for. Use 'me' to get teams for the current user.

- opt_fields (string): Comma-separated list of optional fields to include

- Get teams in a workspace
- Required input:

- workspace_gid (string): The workspace GID to get teams for (optional if DEFAULT_WORKSPACE_ID is set)

- opt_fields (string): Comma-separated list of optional fields to include

- Get users in a workspace
- Required input:

- workspace_id (string): The workspace ID to get users for (optional if DEFAULT_WORKSPACE_ID is set)

- limit (integer): Results per page (1-100)
- offset (string): Pagination offset token
- opt_fields (string): Comma-separated list of optional fields to include (defaults to "name,email")
- auto_paginate (boolean): Whether to automatically fetch all pages
- max_pages (integer): Maximum number of pages to fetch when auto_paginate is true

- Get the complete hierarchical structure of an Asana project, including sections, tasks, and subtasks
- Required input:

- project_id (string): The project ID to get hierarchy for

- include_completed_tasks (boolean): Include completed tasks (default: false)
- include_subtasks (boolean): Include subtasks for each task (default: true)
- include_completed_subtasks (boolean): Include completed subtasks (default: follows include_completed_tasks)
- max_subtask_depth (number): Maximum depth of subtasks to retrieve (default: 1)
- opt_fields_tasks (string): Optional fields for tasks
- opt_fields_subtasks (string): Optional fields for subtasks
- opt_fields_sections (string): Optional fields for sections
- opt_fields_project (string): Optional fields for project
- limit (number): Max results per page (1-100)
- offset (string): Pagination token from previous response
- auto_paginate (boolean): Whether to automatically fetch all pages
- max_pages (number): Maximum pages to fetch when auto_paginate is true

- List attachments for a specific object (task, project, etc.)
- Required input:

- object_gid (string): The object GID to retrieve attachments for

- limit (number): Results per page (1-100)
- offset (string): Pagination offset token
- opt_fields (string): Comma-separated list of optional fields to include

- Upload a local file as attachment to a task or other object
- Required input:

- object_gid (string): The object GID to attach the file to
- file_path (string): Path to the local file to upload

- file_name (string): Custom file name
- file_type (string): MIME type of the uploaded file

- Download an attachment to a local directory
- Required input:

- attachment_gid (string): The attachment GID to download

- output_dir (string): Directory to save the file (default: ~/downloads)
- task-summary

- Get a summary and status update for a task based on its notes, custom fields and comments
- Required input:

- task_id (string): The task ID to get summary for

- Visit theAsana.
- Click "Sign up".

- https://app.asana.com/0/my-apps

- If you primarily work with one workspace, you can set a default workspace ID.
- Use the Asana API to list your workspaces, or go to your workspace in Asana and copy the ID from the URL.
- When you set a default workspace ID, you won't need to specify the workspace for each API call.
- Without a default workspace, the server will callasana_list_workspacesto get the list of available workspaces.