MCP Asana

This is an MCP protocol server that provides functions for integrating with the Asana task and project management tool, including creating, updating, listing, and deleting tasks and projects.

Developer tools Schedule management #Task management #Project collaboration #Asana integration .JavaScript

rating : 2 points

downloads : 12

update time : 2025-04-28

What is the MCP Asana Integration Server?

This is a server based on the Model Context Protocol, specifically designed to integrate with the Asana project management platform. It allows users to manage tasks and projects in Asana through simple commands without directly using the Asana interface.

How to use the MCP Asana integration?

After installation and configuration, you can send instructions via the command line or the MCP protocol to manage Asana tasks and projects. The server supports common operations such as creating tasks, updating task status, and viewing project lists.

Applicable scenarios

Suitable for teams that need to automate the management of Asana tasks or developers who want to integrate Asana functions into their existing workflows. Particularly applicable to CI/CD processes, automation scripts, and custom dashboard development.

Main features

Task managementSupports creating, updating, viewing, and deleting Asana tasks. You can set the task name, description, due date, and assignee.

Project managementSupports creating, viewing, and deleting Asana projects. You can set the project name, notes, color, and visibility.

Command-line integrationProvides a simple command-line client that allows you to manage Asana tasks directly from the terminal.

Advantages and limitations

Advantages

Manage tasks without logging in to the Asana web interface

Support integration with automated workflows

Provide a simple command-line operation method

Seamlessly integrate with other MCP services

Limitations

Requires pre - configuration of Asana API access permissions

Does not support complex task dependency management

The list function does not currently support pagination

Limited error handling capabilities

How to use

Installation preparation

Ensure that Node.js (v14 or higher) is installed and obtain an Asana personal access token.

Project installation

Clone the repository and install dependencies.

Configure the environment

Copy the.env.example file and configure your Asana access token and default project/workspace ID.

Start the server

Build and start the MCP server.

Usage examples

Automate daily task creationAutomatically create today's to - do list every morning.

Project progress checkRegularly check unfinished tasks in a project.

Batch close completed tasksMark all completed tasks as completed.

Frequently Asked Questions

How to obtain an Asana personal access token?

Why did my task creation fail?

How to find my workspace ID and project ID?

What date formats are supported?

Related resources

Asana official API documentation

Complete reference documentation for the Asana API

MCP protocol specification

Official specification of the Model Context Protocol

GitHub repository

Project source code and issue tracking

🚀 MCP Asana Integration Server

This is a server based on the Model Context Protocol (MCP) that provides tools for managing Asana tasks and projects. The server exposes methods for creating, updating, listing, and deleting Asana tasks and projects.

✨ Features

Task Management
- Create new Asana tasks with a name, description, due date, assignee, and parent project.
- List tasks within a specific project.
- Update existing Asana tasks (name, description, due date, assignee, completion status).
- Delete Asana tasks.
Project Management
- Create new Asana projects with a name, description, color, and visibility settings.
- List all projects within a workspace.
- Delete Asana projects.

📦 Prerequisites

Node.js version 14 or higher.
Install Asana developer credentials:
```
cp .env.example .env && edit .env
```

📦 Installation

git clone [repository URL]
cd mcp-asana
npm install

📚 Configuration

Copy the .env.example file and modify it as follows:

ASANA_ACCESS_TOKEN=your_asana_access_token
ASANA_PROJECT_ID=your_asana_project_id
ASANA_WORKSPACE_ID=your_asana_workspace_id

💻 Usage Examples

Basic Usage

Run the server
```
npm run build && npm start
```
Development mode
```
npm run dev
```
Simple client
```
./simple-client.sh [command]
```
- ./simple-client.sh create-task: Create a task.
- ./simple-client.sh list-tasks: List all tasks.
- ./simple-client.sh update-task: Update a task.
- ./simple-client.sh delete-task: Delete a task.

📚 Documentation

Project Structure

mcp-asana/
├── asana/              # Asana API integration
│   ├── config.js       # Configuration and utility tools
│   ├── index.js        # Main entry point
│   ├── index.d.ts      # TypeScript declaration file
│   ├── projects.js     # Project management functions
│   └── tasks.js        # Task management functions
├── src/
│   ├── server.ts       # MCP server implementation
│   └── simple-client.ts # Command-line client
├── dist/               # Compiled JavaScript files
├── simple-client.sh    # Shell script
├── listWorkspaces.js   # Tool to list all workspaces
├── listAllProjects.js  # Tool to list all projects
├── .env.example        # Example environment file
└── package.json        # Project dependencies