mcp-registry/mcp-server-asana

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-server-asana

by roychri

Model Context Protocol (MCP) server implementation that exposes Asana’s REST API as MCP tools, resources and prompts. Lets Claude Desktop / Code and other MCP clients interact with Asana workspaces, projects, tasks, comments, etc.

90
32
Open Source
GitHubNPM

Installation

1. Prerequisites
• Node.js ≥ 18 and npm (comes with Node)
• An Asana Personal Access Token (PAT) with read-write permissions for the workspace you want the MCP server to manage.
2. Install the package
# inside your existing MCP server workspace or a fresh folder
npm install mcp-server-asana --save
3. Create a configuration file (e.g. .env or config/mcp-asana.json)
ASANA_ACCESS_TOKEN=<your-asana-pat>
ASANA_WORKSPACE_ID=<workspace-id>
PORT=8080 # port the MCP server should listen on
4. Build the TypeScript sources (only required if you are working from the Git repo)
npm run build
5. Start the server
npx mcp-server-asana start # or: npm run start
6. Check health
Visit http://localhost:8080/health or use `curl`:
curl http://localhost:8080/health
A JSON payload like `{ "status": "ok" }` should be returned.
7. (Optional) Run as a background service
pm install -g pm2
pm2 start "npm run start" --name mcp-asana
pm2 save

Documentation

# Supercharge Your Development Workflow with Asana + Augment Code

Transform Augment Code into a powerful project management hub with the MCP server for Asana. This integration brings your entire Asana workspace directly into your coding environment, eliminating the constant context switching between your IDE and project management tools that kills developer productivity.

## Seamless Project Management from Your Code Editor

With this MCP server connected to Augment Code, you can manage your entire development lifecycle without leaving your coding environment. Ask Augment to "show me all open tasks in the Sprint 30 project" or "create a task for the authentication bug I just found" and watch as it seamlessly queries your Asana workspace, creates tasks with proper descriptions, and even sets up task dependencies—all while you stay focused on coding.

The server's comprehensive tool suite enables Augment to handle complex project workflows: checking task completion status before merging PRs, automatically creating subtasks when breaking down features, updating project status with technical details, and even analyzing task completeness to ensure nothing falls through the cracks. You'll spend less time managing projects and more time building great software.

## Real-World Developer Benefits

**Sprint Planning Made Effortless**: Have Augment analyze your current sprint, identify blockers, and suggest task prioritization based on dependencies. "Check our sprint progress and tell me which tasks are blocking others" becomes a simple conversation with your AI assistant.

**Bug-to-Task Automation**: When you discover a bug, simply describe it to Augment and watch it create a properly formatted Asana task with technical details, assign it to the right project, and even set up dependencies if it's blocking other work.

**Code Review Integration**: During code reviews, ask Augment to "update the task status for this feature and add a comment about the implementation approach" - it will find the relevant task and update it with technical context.

**Team Coordination**: Use Augment to quickly check what your teammates are working on, see project status updates, and coordinate dependencies across multiple workstreams without opening Asana.

The MCP server's 22 specialized tools give Augment unprecedented control over your Asana workspace, turning your AI coding assistant into a comprehensive project management partner that understands both your code and your workflow.
License: MIT License
Updated 7/15/2025

Table of Contents

mcp-server-asana - MCP Server Registry - Augment Code