Summary
Wraps Asana's REST API through OAuth so Claude can query your project management data directly. Currently exposes one tool to list workspaces, returning the IDs needed for project and task operations. Hosted through Pipeworx's gateway, which means you can either connect to the standalone Asana endpoint or add the full Pipeworx gateway for 673+ data sources. Includes an ask_pipeworx function that handles tool selection and argument mapping from natural language queries. Useful if you're already running Asana workspaces and want Claude to pull task lists, project status, or workspace metadata without switching contexts.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
10 tools
get_attachmentsList all attachments for a project, project brief, or task. Returns attachment names, IDs, and URLs (download_url, permanent_url, view_url). Use for accessing files attached to Asana objects. Supports pagination for objects with many attachments.4 params
List all attachments for a project, project brief, or task. Returns attachment names, IDs, and URLs (download_url, permanent_url, view_url). Use for accessing files attached to Asana objects. Supports pagination for objects with many attachments.
Parameters* required
limitnumberResults per page (1-100)
offsetstringPagination offset token
opt_fieldsstringComma-separated list of optional fields to include in the response
parentstringThe GID of the parent project, project_brief, or task to retrieve attachments for. Must be a GID for a project, project_brief, or task.
get_portfolioGet detailed portfolio data by ID including name, owner, and projects. Use after finding portfolio ID via search_objects. Returns complete portfolio configuration. Essential for understanding portfolio context and content.2 params
Get detailed portfolio data by ID including name, owner, and projects. Use after finding portfolio ID via search_objects. Returns complete portfolio configuration. Essential for understanding portfolio context and content.
Parameters* required
opt_fieldsstringComma-separated list of optional fields to include in the response
portfolio_gidstringGlobally unique identifier for the portfolio
get_portfoliosList portfolios in workspace owned by the current user. REQUIRES workspace parameter. Returns portfolio names and IDs for portfolios you own. Use for portfolio discovery and management. Supports pagination for workspaces with many portfolios.3 params
List portfolios in workspace owned by the current user. REQUIRES workspace parameter. Returns portfolio names and IDs for portfolios you own. Use for portfolio discovery and management. Supports pagination for workspaces with many portfolios.
Parameters* required
limitnumberResults per page (1-100)
offsetstringPagination offset token
opt_fieldsstringComma-separated list of optional fields to include in the response
get_items_for_portfolioList projects, goals, and other items in a portfolio. Returns item names, IDs, and types. Use for portfolio content exploration and management. Supports pagination for portfolios with many items.4 params
List projects, goals, and other items in a portfolio. Returns item names, IDs, and types. Use for portfolio content exploration and management. Supports pagination for portfolios with many items.
Parameters* required
limitnumberResults per page (1-100)
offsetstringPagination offset token
opt_fieldsstringComma-separated list of optional fields to include in the response
portfolio_gidstringGlobally unique identifier for the portfolio
get_projectGet detailed project data including name, description, owner, members, and current status. Also returns task counts (num_tasks, num_incomplete_tasks, num_completed_tasks) and optionally sections. A null task_counts or sections value means the data could not be retrieved and sh...3 params
Get detailed project data including name, description, owner, members, and current status. Also returns task counts (num_tasks, num_incomplete_tasks, num_completed_tasks) and optionally sections. A null task_counts or sections value means the data could not be retrieved and sh...
Parameters* required
include_sectionsbooleanSet to true to include the project's sections (up to 50) in the response.default: false
opt_fieldsstringComma-separated list of optional fields to include in the response.
project_idstringGlobally unique identifier for the project.
get_projectsList projects in a workspace, optionally filtered by team. Returns project names, IDs, owner info, and task counts (num_tasks, num_incomplete_tasks, num_completed_tasks). A null task_counts value means counts could not be retrieved and should not be interpreted as zero.5 params
List projects in a workspace, optionally filtered by team. Returns project names, IDs, owner info, and task counts (num_tasks, num_incomplete_tasks, num_completed_tasks). A null task_counts value means counts could not be retrieved and should not be interpreted as zero.
Parameters* required
archivedbooleanInclude archived projects.default: false
limitnumberNumber of projects to return per page (1-100). Defaults to 20.default: 20
offsetstringPagination offset token from the next_page field of a previous response. If omitted, returns the first page of results.
opt_fieldsstringComma-separated list of optional fields to include in the response.
teamstringWhen passed in, filters projects on team GID
create_project_status_updatePost a status update to a project or portfolio. Use for project health updates, milestone documentation, or blocker reporting. Returns created status with gid, parent, title, status_type, author, created_at, permalink_url. One of text or html_text must be provided.5 params
Post a status update to a project or portfolio. Use for project health updates, milestone documentation, or blocker reporting. Returns created status with gid, parent, title, status_type, author, created_at, permalink_url. One of text or html_text must be provided.
Parameters* required
colorstringStatus color: green (on track), yellow (at risk), red (off track), blue (on hold), completeone of
green · yellow · red · blue · completehtml_textstringHTML formatted text for the status update. One of text or html_text must be provided. It must be wrapped in a <body> tag. You can create links to other asana objects with the following instructions...
parentstringGID of the project or portfolio to post the status update to.
textstringStatus body text. One of text or html_text must be provided.
titlestringStatus title
create_projectCreate a new project with optional sections and tasks in a single operation. Optionally pass sections, each with a sectionName and an optional list of tasks (with name, assignee, due_on, etc.), to set up the full project structure at creation time. Tasks are nested within thei...14 params
Create a new project with optional sections and tasks in a single operation. Optionally pass sections, each with a sectionName and an optional list of tasks (with name, assignee, due_on, etc.), to set up the full project structure at creation time. Tasks are nested within thei...
Parameters* required
colorstringColor of the project (light-green, dark-green, light-blue, dark-blue, etc).one of
dark-pink · dark-green · dark-blue · dark-red · dark-teal · dark-browncustom_fieldsobjectObject mapping custom field GIDs to their values. Example: {"123456": "option_gid", "789012": 42}.
default_access_levelstringThe default access for users or teams who join or are added as members to the project.one of
admin · editor · commenter · viewerdefault_viewstringThe default view of the project (list, board, calendar, timeline).one of
list · board · calendar · timelinedefault: listdue_onstringDate on which this project is due (YYYY-MM-DD).
html_notesstringHTML-formatted description for the project. It must be wrapped in a <body> tag. You can create links to other asana objects with the following instructions: For <a> tags specifically, to make it ea...
membersstringComma-separated user GIDs to add as project members. Example: "123456,789012".
namestringName of the project.
notesstringPlain description for the project. If the description contains @-mentions, use the html_notes parameter instead.
ownerstringUser identifier for project owner. Can be "me", an email, or a user GID. Prefer using "me" for the current user rather than calling get_me to look up the GID of the current user.
privacy_settingstringPrivacy level for the project (public_to_workspace, private_to_team, private).one of
public_to_workspace · private_to_team · privatesectionsarrayUsers will give you a request to create a project with a certain purpose.
JSON array of section objects. Each section must have:
- sectionName (string): Name of the section.
- tasks (array, option...
start_onstringDate on which this project is started (YYYY-MM-DD).
teamstringGlobally unique identifier for the team. If not provided, default team will be used.
get_status_overviewGet status overview and progress reports for initiatives/projects. Use this tool as a standalone when users ask for: status updates, status reports, project status, work overview, progress overview, initiative status, identified blockers, or any status-related queries. This to...2 params
Get status overview and progress reports for initiatives/projects. Use this tool as a standalone when users ask for: status updates, status reports, project status, work overview, progress overview, initiative status, identified blockers, or any status-related queries. This to...
Parameters* required
keywordsstringKeywords to search for projects. Can be a single keyword (e.g., 'asana') or multiple comma-separated keywords (e.g., 'asana, chatgpt, integration'). The tool searches each keyword separately and co...
opt_fieldsstringComma-separated list of optional fields to include in task data (e.g., 'name,notes,assignee,due_on,completed').
search_tasksPremium accounts only. Advanced task search with full-text and complex filters. Searches task names, descriptions, and comments. Returns tasks with gid, name, assignee, due_on, completed. When the user asks about tasks assigned to them, use assignee_any="me" for best results....28 params
Premium accounts only. Advanced task search with full-text and complex filters. Searches task names, descriptions, and comments. Returns tasks with gid, name, assignee, due_on, completed. When the user asks about tasks assigned to them, use assignee_any="me" for best results....
Parameters* required
assignee_anystringFilter to tasks assigned to any of these users. Comma-separated list of user identifiers ("me", an email, or a user GID).
completedbooleanFilter for completed or incomplete tasks.
completed_at_afterstringISO 8601 datetime string for completion datetime after filter.
completed_at_beforestringISO 8601 datetime string for completion datetime before filter.
completed_on_afterstringISO 8601 date string for completion date after filter.
completed_on_beforestringISO 8601 date string for completion date before filter.
created_at_afterstringISO 8601 datetime string for creation datetime after filter.
created_at_beforestringISO 8601 datetime string for creation datetime before filter.
created_by_anystringFilter to tasks created by any of these users. Comma-separated list of user identifiers ("me", an email, or a user GID).
created_on_afterstringISO 8601 date string for creation date after filter.
created_on_beforestringISO 8601 date string for creation date before filter.
custom_fieldsstringJSON string of custom field filters. Example: {"4578152156": "Not Started", "5678904321": 42}.
due_onstringISO 8601 date string for due date filter.
due_on_afterstringISO 8601 date string for due date after filter.
due_on_beforestringISO 8601 date string for due date before filter.
followers_anystringFilter to tasks followed by any of these users. Comma-separated list of user identifiers ("me", an email, or a user GID).
is_subtaskbooleanFilter to subtasks.
limitnumberMaximum number of results to return (1-100). Default: 50.default: 50
modified_at_afterstringISO 8601 datetime string for modified datetime after filter.
modified_on_afterstringISO 8601 date string for modified date after filter.
+8 more parameters. See the server's own documentation for the full schema.
mcp-asana
Asana MCP — wraps the Asana REST API (OAuth)
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
asana_list_workspaces | Get all accessible Asana workspaces. Returns workspace names and IDs needed to list projects and tasks. |
asana_list_tasks | List tasks in a project. Returns task ID, name, completion status, assignee, and due date. Requires project ID. |
asana_get_task | Get full task details including name, description, assignee, projects, tags, subtasks, and status. Requires task ID. |
asana_create_task | Create a new task in a project. Returns task ID, name, and permalink. Requires project ID and task name. |
asana_list_projects | List all projects in a workspace. Returns project ID, name, and archived status. Requires workspace ID. |
asana_search_tasks | Search tasks across a workspace by keyword. Returns matching tasks with ID, name, completion status, and assignee. Requires workspace ID. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"asana": {
"url": "https://gateway.pipeworx.io/asana/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/asana/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Asana data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →