Asana MCP Server

A Model Context Protocol (MCP) server that provides integration with Asana, allowing AI assistants like Claude to interact with your Asana workspaces, projects, and tasks.

Features

• Get information about workspaces, projects, and tasks
• Create, update, and delete tasks
• Create and update projects
• Search for tasks across workspaces and projects
• Manage task assignments and deadlines
• Work with project sections
• Support for both personal and organization workspaces
• TypeScript definitions included for better developer experience

Prerequisites

• Node.js v16 or higher
• An Asana account
• A Personal Access Token from Asana

Installation

Option 1: Install via npm (Recommended)

No installation required! Just configure Claude Desktop directly with npx.

Option 2: Global Installation

npm install -g asana-by-moonbird

Option 3: Install from Source

1. Clone this repository or download the source code
2. Install dependencies:

   npm install

3. Make the main script executable:

   chmod +x index.js

Getting an Asana Personal Access Token

1. Log in to your Asana account
2. Navigate to https://app.asana.com/0/developer-console
3. Click on "Create new personal access token"
4. Give your token a name (e.g., "Claude MCP")
5. Copy the generated token (you'll only see it once)

Setup with Claude Desktop

For npm Installation

Recommended: Using npx (no installation required)

{
  "mcpServers": {
    "asana-tasks": {
      "command": "npx",
      "args": ["asana-by-moonbird", "--token", "YOUR_ASANA_TOKEN"]
    }
  }
}

Alternative: Global Installation

{
  "mcpServers": {
    "asana-tasks": {
      "command": "asana-mcp-server",
      "args": ["--token", "YOUR_ASANA_TOKEN"]
    }
  }
}

Note: Global method requires npm install -g asana-by-moonbird first

For Source Installation

{
  "mcpServers": {
    "asana-tasks": {
      "command": "node",
      "args": ["/path/to/asana-mcp-server/index.js", "--token", "YOUR_ASANA_TOKEN"]
    }
  }
}

After updating the configuration, restart Claude Desktop.

Usage for Your Team

Team Installation Instructions

Super Simple - No Installation Required!

1. Get your Asana Personal Access Token (see instructions above)

2. Configure Claude Desktop:

   • Open ~/Library/Application Support/Claude/claude_desktop_config.json
   • Add this configuration:

   {
     "mcpServers": {
       "asana-tasks": {
         "command": "npx",
         "args": ["asana-by-moonbird", "--token", "YOUR_ASANA_TOKEN"]
       }
     }
   }

   • Replace YOUR_ASANA_TOKEN with your actual token

3. Restart Claude Desktop

That's it! No npm installation required. npx will automatically download and run the package when Claude needs it.

Alternative: Global Installation Method

If you prefer to install globally first:

1. Install the package globally:

   npm install -g asana-by-moonbird

2. Get your Asana Personal Access Token (see instructions above)

3. Configure Claude Desktop:

   • Open ~/Library/Application Support/Claude/claude_desktop_config.json
   • Add the asana-tasks server configuration:

   Method 1 (Recommended): Global Command

   {
     "mcpServers": {
       "asana-tasks": {
         "command": "asana-mcp-server",
         "args": ["--token", "YOUR_ASANA_TOKEN"]
       }
     }
   }

   Method 2 (Fallback): Using npx

   {
     "mcpServers": {
       "asana-tasks": {
         "command": "npx",
         "args": ["asana-by-moonbird", "--token", "YOUR_ASANA_TOKEN"]
       }
     }
   }

   • Replace YOUR_ASANA_TOKEN with your actual token

4. Restart Claude Desktop

Usage Examples

Once installed, Claude will automatically detect the Asana tools. You can ask Claude to perform tasks such as:

• "Show me my Asana workspaces"
• "Create a new task in project X"
• "What tasks do I have due this week?"
• "Update the deadline for task Y"
• "Show me all tasks in project Z"
• "Create a new project in workspace A"
• "Add a comment to task ABC with the text 'Great work!'"
• "Move task XYZ to the 'In Progress' section"

Available Tools

The server provides the following tools for Claude:

Workspace Management

• asana_get_workspaces - Get a list of workspaces
• asana_get_workspace - Get details of a specific workspace
• asana_get_teams - Get teams in an organization workspace

Project Management

• asana_get_projects - Get a list of projects in a workspace
• asana_create_project - Create a new project in a workspace
• asana_get_project - Get details of a specific project
• asana_update_project - Update a project
• asana_get_project_sections - Get sections in a project

Task Management

• asana_get_project_tasks - Get tasks in a project
• asana_get_task - Get details of a specific task
• asana_create_task - Create a new task
• asana_update_task - Update a task
• asana_delete_task - Delete a task
• asana_get_my_tasks - Get tasks assigned to the current user
• asana_search_tasks - Search for tasks in a workspace

Collaboration

• asana_add_task_to_section - Add a task to a section
• asana_add_comment_to_task - Add a comment to a task
• asana_get_task_stories - Get stories (comments, system actions) for a task

Organization vs Personal Workspaces

Asana has two types of workspaces:

1. Personal Workspaces - Simple workspaces for individual use
2. Organization Workspaces - Enterprise workspaces with team structures

When creating projects in an organization workspace, you must provide a team ID:

1. First determine if your workspace is an organization using asana_get_workspace
2. If it is (has is_organization: true), get the available teams using asana_get_teams
3. When creating a project, include both the workspace_gid and a team parameter with the team's GID

Development

Running in Debug Mode

asana-mcp-server --token YOUR_ASANA_TOKEN --debug

Or from source:

node index.js --token YOUR_ASANA_TOKEN --debug

TypeScript Support

This package includes TypeScript definitions. If you're using it programmatically:

import { AsanaClient } from 'asana-by-moonbird';

const client = new AsanaClient('your-token');
const workspaces = await client.getWorkspaces();

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Changelog

See CHANGELOG.md for version history and changes.

License

MIT - see LICENSE file for details.

Support

• 📚 Documentation
• 🐛 Report Issues
• 💬 Discussions

Note: This is an unofficial integration and is not affiliated with Asana, Inc.