MCP Server for Asana

Name: MCP Server for Asana
Author: roychri

@roychri

Repository

About MCP Server for Asana

No overview available yet

Basic information

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

List of workspaces

List of matching projects

List of matching tasks

Detailed task information

Created task information

List of task stories/comments

Updated task information

Detailed project information

Task count information

List of project sections

Created story information

Updated task dependencies

Updated task dependents

Created subtask information

List of detailed task information

Project status information

List of project status updates

Created project status information

Deletion confirmation

Updated task information

Detailed tag information

List of tags associated with the task

List of tasks for the specified tag

List of tags in the workspace

Updated tag information

Deletion confirmation

Created tag information

Success response

Success message confirming the task was added to the project

If no positioning arguments are given, the task will be added to the end of the project

Success message confirming the task was removed from the project

The task will still exist in the system, but it will not be in the project anymore

Success message confirming the task was deleted

This action cannot be undone. The task will be permanently removed.

The created project object

Updated project information

Created section information

Updated section information

Deletion confirmation

Success confirmation

Array of subtask objects

Array of task objects

List of tasks from the user's My Tasks list

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.