home / mcp / asana mcp server

Asana MCP Server

Exposes Asana data via MCP: list projects, sections, tasks and task activity for AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bnwebdev-tiny-asana-mcp-server": {
      "command": "env",
      "args": [
        "ASANA_TOKEN=your_asana_personal_access_token",
        "npx",
        "-y",
        "tiny-asana-mcp-server"
      ],
      "env": {
        "ASANA_TOKEN": "your_asana_personal_access_token"
      }
    }
  }
}

You can run a lightweight MCP server that lets AI assistants manage your Asana workspace. It exposes standardized MCP tools to list projects and sections, read task details and comments, and fetch tasks, enabling seamless task management through AI interactions.

How to use

Start the Asana MCP Server with your Asana Personal Access Token. The server runs locally and exposes MCP tools that your AI assistant can call to list projects, sections, and tasks, as well as retrieve task details and comments.

How to install

Prerequisites: you need Node.js and npm installed on your system.

# Option 1: Install globally
npm install -g tiny-asana-mcp-server

# Option 2: Run directly with npx
npx tiny-asana-mcp-server

Configuration and usage notes

Create a configuration file or pass the Asana token via environment variables before starting the server. The token gives the server access to your Asana resources.

env ASANA_TOKEN=your_asana_personal_access_token npx -y tiny-asana-mcp-server

Additional considerations

The server supports a set of MCP tools to interact with Asana resources. Start the server with the required token, then use an MCP client to issue the following tool calls to manage and inspect Asana data.

Available tools

asana_get_projects

List all accessible Asana projects.

asana_get_sections_by_project

List sections within a specified project.

asana_get_task_stories

Fetch comments or stories associated with a task.

asana_get_task

Retrieve details for a specific task.

asana_get_tasks_by_project

List tasks within a specified project.

asana_get_tasks_by_section

List tasks within a specific section.