MCP.so
Sign In

MCP Server for Asana

@roychri

Repository

About MCP Server for Asana

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": [
        "-y",
        "@roychri/mcp-server-asana"
      ],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}

Tools

41

List all available workspaces in Asana

Search for projects in Asana using name pattern matching

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.

Search tasks in a workspace with advanced filtering options

Get detailed information about a specific task

Create a new task in a project

Get comments and stories for a specific task

Update an existing task's details

Get detailed information about a specific project

Get the number of tasks in a project

Get sections in a 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.

Create a new project in a workspace or team

Create a comment or story on a task. Either text or html_text is required.

Set dependencies for a task

Set dependents for a task (tasks that depend on this task)

Create a new subtask for an existing task

Get all subtasks of a given task. Returns a compact representation of each subtask.

Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)

Get a project status update

Get all status updates for a project

Create a new status update for a project

Delete a project status update

Set the parent of a task and position the subtask within the other subtasks of that parent

Get detailed information about a specific tag

Get a task's tags

Get tags in a workspace

Update an existing tag

Delete a tag

Get tasks for a specific tag

Create a new tag in a workspace

Add a tag to a task

Remove a tag from a 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.

Remove a task from a project. The task will still exist in the system, but it will not be in the project anymore.

Delete a task. This permanently removes the task and cannot be undone.

Create a new section in a project

Update a section (rename it)

Delete a section from a project

Move a task to a section within its project

Update a project's details (name, description, etc.)

Overview

What is MCP Server for Asana?

MCP Server for Asana is a Model Context Protocol (MCP) server that enables AI assistants (like Anthropic's Claude Desktop) to interact with the Asana API. It allows users to query and manage Asana tasks, projects, workspaces, comments, and more directly through natural language prompts.

How to use MCP Server for Asana?

Set the ASANA_ACCESS_TOKEN environment variable with your Asana personal access token (required). Optionally set READ_ONLY_MODE=true to disable write operations. Then, in an MCP client (e.g., Claude Desktop), ask questions or give commands about Asana items, such as “How many unfinished asana tasks do we have in our Sprint 30 project?”

Key features of MCP Server for Asana

  • List and search workspaces, projects, and tasks
  • Create, update, and read task details
  • Add comments/stories to tasks (create_task_story)
  • Manage subtasks and task dependencies
  • Query project statuses and section information
  • Read-only mode to prevent accidental modifications
  • Advanced task filtering with custom fields and sorting

Use cases of MCP Server for Asana

  • Ask an AI assistant to report the number of unfinished tasks in a specific project
  • Automatically create tasks and assign them based on natural language instructions
  • Retrieve project status updates or task comments for quick summaries
  • Reorganize tasks by setting parent tasks or adding dependencies
  • Search for tasks across workspaces using text, assignee, or completion status

FAQ from MCP Server for Asana

What is an MCP server and how does this work?

MCP (Model Context Protocol) is a standard that lets AI applications like Claude Desktop connect to external tools and APIs. This server implements Asana’s API as a set of MCP tools, so the AI can read and write Asana data based on user prompts.

What credentials do I need to use this server?

You need an Asana personal access token. Set it as the ASANA_ACCESS_TOKEN environment variable. Optionally, you can set READ_ONLY_MODE=true to prevent any write operations.

Can I use this server in read-only mode?

Yes. Set READ_ONLY_MODE=true to disable all tools that create, update, or delete Asana items, along with the create-task prompt. Only read operations will be available.

What tools does this server provide?

The server provides over 20 tools, including: asana_list_workspaces, asana_search_projects, asana_search_tasks, asana_create_task, asana_update_task, asana_get_task, asana_get_task_stories, asana_create_task_story, asana_create_subtask, asana_add_task_dependencies, asana_add_task_dependents, asana_get_project, asana_get_project_status, asana_get_project_statuses, asana_create_project_status, asana_get_tag, and more.

What are the runtime requirements for this server?

The server is a Node.js package distributed via npm (@roychri/mcp-server-asana). You need Node.js installed and an internet connection to reach the Asana API. No additional database or external service is required beyond the Asana account.

Frequently asked questions

What is an MCP server and how does this work?

MCP (Model Context Protocol) is a standard that lets AI applications like Claude Desktop connect to external tools and APIs. This server implements Asana’s API as a set of MCP tools, so the AI can read and write Asana data based on user prompts.

What credentials do I need to use this server?

You need an Asana personal access token. Set it as the `ASANA_ACCESS_TOKEN` environment variable. Optionally, you can set `READ_ONLY_MODE=true` to prevent any write operations.

Can I use this server in read-only mode?

Yes. Set `READ_ONLY_MODE=true` to disable all tools that create, update, or delete Asana items, along with the `create-task` prompt. Only read operations will be available.

What tools does this server provide?

The server provides over 20 tools, including: `asana_list_workspaces`, `asana_search_projects`, `asana_search_tasks`, `asana_create_task`, `asana_update_task`, `asana_get_task`, `asana_get_task_stories`, `asana_create_task_story`, `asana_create_subtask`, `asana_add_task_dependencies`, `asana_add_task_dependents`, `asana_get_project`, `asana_get_project_status`, `asana_get_project_statuses`, `asana_create_project_status`, `asana_get_tag`, and more.

What are the runtime requirements for this server?

The server is a Node.js package distributed via npm (`@roychri/mcp-server-asana`). You need Node.js installed and an internet connection to reach the Asana API. No additional database or external service is required beyond the Asana account.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

roychri

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K