MCP Server Asana

🚀 Asana MCP Server Guide

This guide provides a detailed introduction to the installation, setup, and usage of the Asana MCP Server, including command - line options, function overviews, and advanced features.

🚀 Quick Start

📦 Installation

Install via npm

npm install -g @roychri/mcp-server-asana

Clone the repository (Optional)

If you want to modify the code or view the source code, you can clone the repository:

git clone https://github.com/roychri/mcp-server-asana.git
cd mcp-server-asana
npm install

📋 Command - line Options

Start the server

npx @roychri/mcp-server-asana [--port PORT]

• --port: Specify the port that the server listens on. The default is 3000.

Run in development mode

npm run dev

This will automatically reload on changes and enable debug mode.

✨ Features

Provided Commands

Get workspace information (GET /api/workspaces)

• Returns all workspaces owned by the user and their detailed information.
• Response format: A JSON array, where each element contains the following fields:
  • name: Workspace name (string)
  • id: Global ID (string)
  • type: Resource type (string)
  • is_organization: Whether it is an organizational workspace (boolean)
  • email_domains: List of email domains associated with the workspace (array of strings)

Get project information (GET /api/projects)

• Returns all projects owned by the user and their detailed information.
• Response format: A JSON array, where each element contains the following fields:
  • name: Project name (string)
  • id: Global ID (string)
  • type: Resource type (string)
  • archived: Whether it is archived (boolean)
  • public: Whether it is public (boolean)
  • notes: Project description/remarks (string)
  • color: Project color (string)
  • default_view: Default view type (string)
  • due_date, due_on, start_on: Project date information (string)
  • workspace: Workspace object
  • team: Team object
  • sections: Array of sections in the project
  • custom_fields: Array of custom field definitions for the project

🔧 Technical Details

Resource Representation

Workspace resource (asana://workspace/{workspace_gid})

• Represents a resource of an Asana workspace.
• Each workspace is exposed as a separate resource.
• URI format: asana://workspace/{workspace_gid}
• Returns: A JSON object containing the following fields:
  • name: Workspace name (string)
  • id: Global ID (string)
  • type: Resource type (string)
  • is_organization: Whether it is an organizational workspace (boolean)
  • email_domains: List of email domains (array of strings)

Project resource (asana://project/{project_gid})

• A template resource for getting detailed project information by GID.
• URI format: asana://project/{project_gid}