MCP Server for 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