asanamcp

# Homebrew brew install adlio/tap/asanamcp # From crates.io cargo install asanamcp # From GitHub cargo install --git https://github.com/adlio/asanamcp

- Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "asana": { "command": "asanamcp", "env": { "ASANA_TOKEN": "your-personal-access-token", "ASANA_DEFAULT_WORKSPACE": "your-workspace-gid" } } } }

TheASANA_DEFAULT_WORKSPACEis optional but recommended if you work primarily in one workspace. When set, workspace-based operations (search, list projects, list users, etc.) will use this default, reducing the need to specify workspace GID in every request.

# Dump tool schemas (useful for debugging) asanamcp --schema # Dump a specific tool's schema asanamcp --schema get # Launch the MCP Inspector (interactive web UI) make inspect

Fetch any Asana resource with recursive traversal support.

{"resource_type": "portfolio", "gid": "123", "depth": -1}

UsesASANA_DEFAULT_WORKSPACEif gid is empty.

{"resource_type": "task", "project_gid": "123", "name": "New task", "assignee": "me"}

UsesASANA_DEFAULT_WORKSPACEif not provided.

{"resource_type": "task", "gid": "123", "completed": true}

Supports:task,project,portfolio,section,tag,comment,status_update,project_brief(Key Resources on Overview tab, NOT the Note tab).

Permanently delete an Asana resource. This action isirreversible.

{"resource_type": "task", "gid": "123"}

Supports:task,project,portfolio,section,tag,comment,status_update,project_brief.

{"action": "add", "relationship": "task_project", "target_gid": "task123", "item_gid": "proj456"}

Useitem_gidfor single items oritem_gidsfor bulk operations.

Search for tasks with rich filtering options.

{"workspace_gid": "123", "text": "bug", "completed": false, "assignee": "me"}

Search for any Asana resource by name using typeahead. Use this to find projects, templates, users, teams, and more.

{"query": "CloudSmith", "resource_type": "project_template"}