@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