Log inSubmit server
MCP Server Asana logo

MCP Server Asana

by roychri

Connects MCP clients to Asana for searching, reading, creating, and updating tasks, projects, comments, and dependencies.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Asana

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "roychri-mcp-server-asana": {
      "command": "npx",
      "args": [
        "-y",
        "@roychri/mcp-server-asana"
      ],
      "env": {
        "ASANA_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "READ_ONLY_MODE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @roychri/mcp-server-asana

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The roychri/mcp-server-asana MCP server exposes Asana API operations as tools for MCP clients, including Claude Desktop. It supports workspace and project discovery, task search and retrieval, task creation and updates, comments, subtasks, dependencies, project sections, task counts, and project status information. Configure an Asana access token, then use natural-language requests to work with Asana data through a compatible client. Enable read-only mode when you need to prevent task and other write operations.

Use cases

  • Search unfinished tasks in an Asana project
  • Create tasks and subtasks from agent conversations
  • Review task comments and activity
  • Update due dates, assignees, and completion state
  • Inspect project sections, counts, and status updates

Key features

  • Search Asana tasks with advanced filters
  • Read workspaces, projects, tasks, and stories
  • Create and update tasks and subtasks
  • Manage task comments and dependencies
  • Support read-only operation mode
  • Retrieve project status information

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

21/22 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @roychri/mcp-server-asana (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars149Stargazers on the source repository.
npm downloads19kPackage downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Asana works

What roychri/mcp-server-asana MCP server does

The roychri/mcp-server-asana MCP server connects an MCP client to Asana’s API. It gives an agent structured operations for inspecting and changing Asana workspaces, projects, tasks, and task activity. The repository specifically identifies Anthropic’s Claude Desktop application as a supported example, while the implementation is intended for MCP clients more generally.

Read operations cover workspace listing, project lookup, task search, task details, task stories, project details, project task counts, project sections, multiple-task retrieval, and project status information. Search can use task text and several Asana attributes, including completion state, subtasks, attachments, dependencies, assignees, projects, sections, tags, teams, and custom fields.

Write operations include creating and updating tasks, creating subtasks, adding task comments or stories, and setting task dependencies and dependents. Task creation and updates can include names, notes, due dates, assignees, followers, parent tasks, projects, resource subtypes, completion state, and custom fields where supported by the individual tool.

How it works

An MCP client sends tool calls to the local server. The server uses the supplied Asana access token to make API requests and returns the resulting workspace, project, task, or story data to the client. Most tools accept an opt_fields value so callers can request selected response fields.

For example, an agent can search a workspace for unfinished tasks, retrieve a task by ID, inspect its comments, and create a follow-up task. Project searches require a workspace and a regular-expression name pattern. Task searches require a workspace and can apply additional filters and sorting. Multiple-task retrieval accepts up to 25 task IDs.

Setup and configuration

Install and run the roychri/mcp-server-asana MCP server through its npm package, then register the local process with the MCP client of your choice. The server requires ASANA_ACCESS_TOKEN, containing an Asana access token.

Set READ_ONLY_MODE to true to disable operations that create, update, or delete Asana data. In that mode, the create-task prompt is also disabled and only read operations remain available. This setting is useful when testing or when the client must not modify the connected workspace.

Tools and capabilities

The documented tool groups include:

  • Listing available Asana workspaces.
  • Searching projects by workspace and name pattern.
  • Searching tasks with filters, sorting, and custom-field criteria.
  • Reading individual tasks, projects, stories, sections, counts, and project statuses.
  • Creating tasks, subtasks, and task stories.
  • Updating tasks and setting dependencies or dependents.
  • Retrieving details for up to 25 tasks by GID in one request.

Tool inputs use Asana identifiers such as workspace IDs, project IDs, task IDs, and project status GIDs. Date fields documented for tasks use YYYY-MM-DD format.

Limitations and notes

The roychri/mcp-server-asana MCP server requires an Asana access token and therefore cannot operate without credentials. Write access is available unless read-only mode is enabled, so clients should treat task creation, updates, comments, and dependency changes as state-changing actions. The documented multiple-task lookup is limited to 25 tasks per call.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Asana

Install the npm package @roychri/mcp-server-asana and register its local process with your MCP client. The server also requires ASANA_ACCESS_TOKEN.

Yes. The README names Anthropic’s Claude Desktop application as an MCP client example.

ASANA_ACCESS_TOKEN is required. READ_ONLY_MODE is optional and accepts true to disable write operations.

Set READ_ONLY_MODE to true. Write tools and the create-task prompt will be disabled.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Asana AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/roychri-mcp-server-asana?style=directory)](https://allmcps.com/mcp/roychri-mcp-server-asana)
HTML Embed
<a href="https://allmcps.com/mcp/roychri-mcp-server-asana"><img src="https://allmcps.com/api/badge/roychri-mcp-server-asana?style=directory" alt="MCP Server Asana on AllMCPs" /></a>