Asana MCP server
Asana's official remote MCP server: search, read, create, and update tasks, projects, and portfolios from your agent.
The Asana MCP server is Asana's official, cloud-hosted integration that lets an AI agent operate on your Asana work graph in real time. It can search across tasks, projects, portfolios, goals, teams, users, tags, and custom fields, read full task and project details including assignments, due dates, custom fields, and comments, and pull status overviews and portfolio rollups. On the write side it can create and update tasks in batches, create projects with sections, post comments and status updates, and delete tasks, with every action constrained to what the authenticated user is allowed to do.
The canonical deployment is the remote V2 endpoint at https://mcp.asana.com/v2/mcp, authenticated with OAuth so there are no long-lived tokens on disk; tokens issued for the MCP app only work against the MCP server, which limits the blast radius if one leaks. (The original V1 beta endpoint at https://mcp.asana.com/sse is deprecated and has been shut down, so use the V2 endpoint.) It also exposes interactive preview tools that let a client draft and review a task, project, or search before committing it, which pairs well with human-in-the-loop agent workflows.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"asana": {
"type": "http",
"url": "https://mcp.asana.com/v2/mcp"
}
}
}claude mcp add --transport http asana https://mcp.asana.com/v2/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| search_objects | Finds resources across task, project, portfolio, goal, team, user, tag, and custom field types. |
| get_task | Retrieves complete task details including assignments, dates, fields, and comments. |
| get_tasks | Fetches filtered task lists by project, section, tag, or assignee. |
| get_my_tasks | Returns the tasks assigned to the authenticated user. |
| search_tasks | Runs advanced full-text task search with complex filters (Premium only). |
| get_project | Retrieves project details, members, task counts, and sections. |
| get_projects | Lists workspace projects with optional team or archive filters. |
| get_portfolio | Fetches portfolio details including owner and associated projects. |
| get_portfolios | Returns portfolios owned by the authenticated user. |
| get_items_for_portfolio | Lists the projects and goals within a portfolio. |
| get_status_overview | Generates aggregated status reports for projects or portfolios. |
| get_attachments | Retrieves file attachments from tasks, projects, or briefs. |
| get_user | Returns user details by GID, email, or 'me'. |
| get_me | Gets the current user's name, email, and workspace memberships. |
| get_users | Lists workspace users with optional team filtering. |
| get_teams | Lists workspace teams with optional user filtering. |
| create_tasks | Creates up to 50 tasks with assignments, dates, and custom fields. |
| create_project | Creates a project with sections and tasks in one operation. |
| update_tasks | Modifies up to 50 tasks' names, assignments, dates, and status. |
| delete_task | Permanently removes a task and its unshared subtasks. |
| add_comment | Posts a comment with text, HTML formatting, and mentions. |
| create_project_status_update | Posts a status update with a color and body text. |
| create_task_preview | Drafts and reviews a single task before creation. |
| create_project_preview | Plans and reviews a structured project before creation. |
| search_tasks_preview | Displays searchable task results in the UI with filtering options. |
What you can do with it
Spin up a project plan from a brief
Describe an initiative and let the agent draft a project with sections and tasks via the preview tools, review it, then create the whole structure in Asana in one step.
Status reporting on autopilot
Pull a portfolio's status overview and recent task activity, then post a project status update with the right color and a concise summary for stakeholders.
FAQ
- Is it free?
- The MCP server is provided by Asana at no extra charge and works with any Asana account, though some tools (such as advanced task search) require a paid Asana tier, and overall usage follows your plan's limits.
- Does it support remote/OAuth?
- Yes. It is a remote server at https://mcp.asana.com/v2/mcp authenticated with OAuth; tokens issued for the MCP app only work against the MCP server. The legacy /sse V1 endpoint has been deprecated and shut down.