@duytnb79/asana-mcp
Allows interaction with the Asana API, providing tools to list projects, tasks, and sections, search tasks, create and update tasks, and add comments to tasks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@duytnb79/asana-mcp list tasks in the 'Website Redesign' project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@duytnb79/asana-mcp
A local MCP server for Asana that uses an Asana personal access token (PAT).
It runs over stdio and calls the standard Asana REST API at https://app.asana.com/api/1.0. It is separate from Asana's hosted MCP server at https://mcp.asana.com/v2/mcp, which requires a registered MCP app and OAuth.
Requirements
Node.js 20+
An Asana personal access token
Access to the Asana workspaces, projects, and tasks you want to use
Create a PAT in the Asana developer console and treat it like a password. The server can only access data and perform actions allowed for the Asana user who owns the token.
Related MCP server: Asana MCP Server
Installation
Local clone
npm install
npm run build
cp .env.example .env
node dist/index.jsPublished package
After this package is published, it can be run with:
npx -y @duytnb79/asana-mcpOr installed globally:
npm install -g @duytnb79/asana-mcp
asana-mcpConfiguration
Create a .env file or provide environment variables through your MCP client:
ASANA_ACCESS_TOKEN="your_asana_personal_access_token"
ASANA_TIMEOUT_MS="10000"
ASANA_MAX_PAGE_SIZE="100"Required:
ASANA_ACCESS_TOKEN
Optional:
ASANA_TIMEOUT_MS— request timeout in milliseconds; defaults to10000ASANA_MAX_PAGE_SIZE— maximum page size exposed by list/search tools; defaults to100and must be between1and100
The server automatically loads .env when running locally.
MCP client configuration
Local build
{
"mcpServers": {
"asana": {
"command": "node",
"args": [
"/Users/genkisystem/Desktop/asana-mcp-server/dist/index.js"
],
"env": {
"ASANA_ACCESS_TOKEN": "your_asana_personal_access_token"
}
}
}
}Alternatively, run through npm from the project directory:
{
"mcpServers": {
"asana": {
"command": "npm",
"args": ["start"],
"cwd": "/Users/genkisystem/Desktop/asana-mcp-server",
"env": {
"ASANA_ACCESS_TOKEN": "your_asana_personal_access_token"
}
}
}
}Published package
{
"mcpServers": {
"asana": {
"command": "npx",
"args": ["-y", "@duytnb79/asana-mcp"],
"env": {
"ASANA_ACCESS_TOKEN": "your_asana_personal_access_token"
}
}
}
}Available tools
Read tools
list_projectsLists projects in a workspace.
Supports
archived,limit,offset, andopt_fields.
list_tasksLists tasks in a project in project priority order.
Supports
completed_since,limit,offset, andopt_fields.
get_taskGets one task by GID.
search_tasksSearches a workspace by assignee, completion state, modified time, project, or text.
Asana search is eventually consistent and may lag recent writes by 10–60 seconds.
The search endpoint does not support normal Asana offset pagination and returns at most 100 items.
list_sectionsLists sections in a project.
Supports
limit,offset, andopt_fields.
Write tools
create_taskCreates a task or subtask.
Requires at least one of
workspace,projects, orparent.
update_taskUpdates fields on an existing task.
add_commentAdds a plain-text comment to a task.
Write tools make immediate changes in Asana. Configure your MCP client to require approval for these tools if you want a human confirmation step.
Pagination
Asana list endpoints return an opaque next_page.offset. The MCP response exposes it as meta.next_offset.
Pass that value back as offset to retrieve the next page. Only use offsets returned by Asana; they can expire when underlying data changes.
Input/output fields
Asana returns compact objects by default. Use opt_fields to request additional properties, for example:
{
"project_gid": "12345",
"limit": 50,
"opt_fields": [
"name",
"completed",
"assignee.name",
"due_on",
"permalink_url"
]
}Keep opt_fields focused. Very broad or deeply nested responses are more expensive and may be rate-limited.
Rate limits and errors
Asana returns HTTP
429when a token is rate-limited.The server reports the
Retry-Aftervalue when Asana provides it, but does not automatically retry write requests because retries could duplicate creations or comments.Authentication, permission, validation, not-found, timeout, and server errors are converted into readable MCP errors.
The PAT is sent only in the
Authorization: Bearerheader and is never placed in request URLs.
Security
Never commit
.envor a PAT.Prefer a dedicated PAT with the minimum user permissions needed for this integration.
Rotate the PAT if it is exposed.
Tool calls run with the permissions of the token owner.
This server intentionally exposes specific Asana operations rather than a generic HTTP passthrough tool.
Development
npm run dev
npm run typecheck
npm run build
npm startAvailable Tools
8 toolsadd_commentAdd commentB
Add a plain-text comment to an Asana task. This operation writes to Asana.
Inputs: text (required), task_gid (required), opt_fields.
create_taskCreate taskC
Create an Asana task. This operation writes to Asana.
Inputs: name (required), tags, liked, notes, +14 more.
get_taskGet taskB
Get details for one Asana task.
Inputs: gid (required), opt_fields.
list_projectsList projectsA
List Asana projects in a workspace with offset pagination.
Inputs: workspace_gid (required), limit, offset, archived, +1 more.
list_sectionsList sectionsA
List sections in an Asana project with offset pagination.
Inputs: project_gid (required), limit, offset, opt_fields.
list_tasksList tasksA
List tasks in an Asana project in project priority order.
Inputs: project_gid (required), limit, offset, opt_fields, +1 more.
search_tasksSearch tasksB
Search tasks in an Asana workspace. Search indexing is eventually consistent and may lag writes by 10-60 seconds.
Inputs: workspace_gid (required), text, limit, project, +6 more.
update_taskUpdate taskC
Update fields on an Asana task. This operation writes to Asana.
Inputs: gid (required), name, liked, notes, +10 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct resource and action: single task retrieval, task listing, project listing, section listing, commenting, creating, updating, and searching. Even list_tasks and search_tasks are clearly differentiated by scope (project vs. workspace).
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_task, list_projects, add_comment, create_task). No mixed conventions or vague verbs.
With 8 tools, the set is well-scoped for an Asana integration, covering tasks, projects, sections, and comments without unnecessary bloat. Each tool serves a clear purpose.
The core task lifecycle is covered with get, list, create, update, and search, but missing a delete_task operation leaves a notable gap. Sections and projects are only listable, but that may be acceptable for the server's scope.
Related MCP Connectors
Unofficial Asana MCP — wraps the Asana REST API (OAuth)
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Unofficial community ClickUp MCP via personal API token. Not affiliated with ClickUp.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) server that enables interacting with the Asana API through natural language commands for task management, project organization, and team collaboration.-
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Asana API, auto-generated using AG2's MCP builder.-
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that connects AI assistants to the Asana API for task, project, and workspace management.33MIT
- AlicenseBqualityDmaintenanceA local MCP server that lets you interact with Asana using a personal access token, providing tools to list projects and tasks, search tasks, create and update tasks, and add comments via the Asana REST API.820 npmMIT