asana

@wwwaldo

About asana

use claude as your project manager

#mcp-asana #task-manager #asana-integration

Config

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

{
  "mcpServers": {
    "mcp-asana": {
      "command": "node",
      "args": [
        "listWorkspaces.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is asana?

The MCP Asana Integration Server is an MCP (Model Context Protocol) server that provides tools for managing Asana tasks and projects. It is intended for developers who want to control Asana via an MCP-compatible AI agent or client.

How to use asana?

Install Node.js (v14+), clone the repository, run npm install, then copy .env.example to .env and populate ASANA_ACCESS_TOKEN, ASANA_PROJECT_ID, and ASANA_WORKSPACE_ID. Build with npm run build and start the server with npm start. The server uses stdio transport; a simple command-line client (simple-client.sh) is included for testing, and the server can be integrated into MCP by adding a "asana" entry to the MCP configuration with the path to dist/server.js.

Key features of asana

Create, list, update, and delete Asana tasks
Create, list, and delete Asana projects
Configuration via environment variables (access token, default project/workspace IDs)
Helper scripts to discover Asana workspace and project IDs
MCP-compatible stdio transport for integration with AI agents

Use cases of asana

Automate task creation, assignment, and updates from an AI assistant
Synchronize project lists and statuses through natural language commands
Quickly delete or archive tasks and projects in bulk via MCP tools
Integrate Asana project management into an AI-powered workflow

FAQ from asana

What prerequisites are required to run asana?

Node.js v14 or higher, an Asana account with API access, and a valid Asana Personal Access Token.

What environment variables are required?

ASANA_ACCESS_TOKEN is required for API authentication. ASANA_PROJECT_ID and ASANA_WORKSPACE_ID are required for full task and project operations respectively.

What data transport is supported?

Only stdio transport is currently supported. HTTP/SSE transport is not implemented.

What are the known limitations of asana?

Limited error handling for API responses, no pagination support for listing tasks or projects, and no HTTP/SSE transport.

How can I find my Asana workspace and project IDs?

The repository includes helper scripts listWorkspaces.js and listAllProjects.js that output the IDs needed for the environment variables.

Frequently asked questions

What prerequisites are required to run asana?

Node.js v14 or higher, an Asana account with API access, and a valid Asana Personal Access Token.

What environment variables are required?

`ASANA_ACCESS_TOKEN` is required for API authentication. `ASANA_PROJECT_ID` and `ASANA_WORKSPACE_ID` are required for full task and project operations respectively.

What data transport is supported?

Only stdio transport is currently supported. HTTP/SSE transport is not implemented.

What are the known limitations of asana?

Limited error handling for API responses, no pagination support for listing tasks or projects, and no HTTP/SSE transport.

How can I find my Asana workspace and project IDs?

The repository includes helper scripts `listWorkspaces.js` and `listAllProjects.js` that output the IDs needed for the environment variables.

Comments

Basic information

More Other MCP servers

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K