@sfdxy/asana-mcp

An MCP (Model Context Protocol) server that gives AI agents full access to Asana project and task management. Designed for free-tier Asana workspaces — no Premium required.

Install

npx @sfdxy/asana-mcp

Or install globally:

npm install -g @sfdxy/asana-mcp

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@sfdxy/asana-mcp"],
      "env": {
        "ASANA_ACCESS_TOKEN": "2/xxxx/xxxx:xxxx"
      }
    }
  }
}

Usage with VS Code

Add to your VS Code mcp.json settings:

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@sfdxy/asana-mcp"],
      "env": {
        "ASANA_ACCESS_TOKEN": "2/xxxx/xxxx:xxxx"
      }
    }
  }
}

Build and Run

npm install
npm run build

Set your Asana Personal Access Token (Generate at Asana Developer Console):

export ASANA_ACCESS_TOKEN="2/xxxx/xxxx:xxxx"

Run the server:

node dist/index.js

Tools

15 tools covering the full Asana workflow. Each tool has one clear job — descriptions tell the LLM when to use it, parameters are flat and obvious.

Tool	Description
asana_me	Get the authenticated user and their workspaces. Call this first.
asana_find_people	Find users by name or list all workspace members.
asana_list_teams	List teams in a workspace for org structure and project filtering.
asana_list_projects	List projects in a workspace (excludes archived by default).
asana_get_project	Get project details including sections, status, members, and notes (plain + HTML).
asana_get_section_tasks	List tasks in a specific board column / section.
asana_manage_sections	Create, rename, or reorder sections (board columns).
asana_search_tasks	Find tasks by name, assignee, or project. Three search strategies for free tier.
asana_get_task	Get full task detail — activity history (comments, assignments, section moves), subtasks, HTML notes.
asana_create_task	Create a task in a project or as a subtask.
asana_update_task	Update fields, reassign, complete, or move to a different section.
asana_comment	Post a comment on a task.
asana_manage_tags	List, create, add, or remove tags.
asana_manage_followers	Add or remove followers on a task.
asana_manage_project	Create or update projects, manage members.

Full parameter reference: docs/tools.md

Common Workflows

"What am I working on?" asana_me -> asana_search_tasks(assignee_id="me")

"Show me the marketing project" asana_list_projects -> asana_get_project -> asana_search_tasks(project_id)

"Create a task and assign to Sarah" asana_find_people(query="Sarah") -> asana_get_project -> asana_create_task

"Move design task to In Progress" asana_search_tasks(query="design") -> asana_get_project -> asana_update_task(section_id)

Documentation

Document	What's in it
docs/tools.md	Full reference for all 15 tools — parameters, return types, API strategies
docs/api.md	Verified Asana endpoints, free-tier limitations, error handling
docs/architecture.md	File layout, library choices, design decisions
docs/development.md	Scripts, guardrails, testing, how to add a new tool

License

ISC