Skip to content
Back to search

mcp-server-asana

This Model Context Protocol server implementation of Asana allows you to talk to Asana API from MCP Client such as Anthropic's Claude Desktop Application, and many more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/roychri--mcp-server-asana/badge.svg)](/listings/roychri--mcp-server-asana)

HTML

<a href="/listings/roychri--mcp-server-asana"><img src="/api/listings/roychri--mcp-server-asana/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. **Create an Asana account**:

- Visit the [Asana](https://www.asana.com). - Click "Sign up".

2. **Retrieve the Asana Access Token**:

- You can generate a personal access token from the Asana developer console. - https://app.asana.com/0/my-apps - More details here: https://developers.asana.com/docs/personal-access-token

3. **Installation Options**:

### For Claude Desktop: Add the following to your `claude_desktop_config.json`:

   {
     "mcpServers": {
       "asana": {
         "command": "npx",
         "args": ["-y", "@roychri/mcp-server-asana"],
         "env": {
           "ASANA_ACCESS_TOKEN": "your-asana-access-token"
         }
       }
     }
   }

### For Claude Code:

Use the following command to install and configure the MCP server:

   claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana

Replace `<TOKEN>` with your Asana access token.

### For Codex CLI:

Add the following to your `~/.codex/config.toml`:

   [mcp_servers.asana]
   command = "npx"
   args = [
     "-y", "@roychri/mcp-server-asana"
   ]
   env = {ASANA_ACCESS_TOKEN= "<TOKEN>"}

Replace `<TOKEN>` with your Asana access token.

If you want to install the beta version (not yet released), you can use:

* `@roychri/mcp-server-asana@beta`

You can find the current beta release, if any, with either:

1. https://www.npmjs.com/package/@roychri/mcp-server-asana?activeTab=versions 2. `npm dist-tag ls @roychri/mcp-server-asana`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 549 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Server for Asana
  2. [![npm version](https://badge.fury.io/js/%40roychri%2Fmcp-server-asana.svg)](https://www.npmjs.com/package/@roychri/mcp-server-asana)
  3. This Model Context Protocol server implementation of Asana allows you
  4. to talk to Asana API from MCP Client such as Anthropic's Claude
  5. Desktop Application, and many more.
  6. More details on MCP here:
  7. - https://www.anthropic.com/news/model-context-protocol
  8. - https://modelcontextprotocol.io/introduction
  9. - https://github.com/modelcontextprotocol
  10. <a href="https://glama.ai/mcp/servers/ln1qzdhwmc"><img width="380" height="200" src="https://glama.ai/mcp/servers/ln1qzdhwmc/badge" alt="mcp-server-asana MCP server" /></a>
  11. ## Environment Variables
  12. - `ASANA_ACCESS_TOKEN`: (Required) Your Asana access token
  13. - `READ_ONLY_MODE`: (Optional) Set to 'true' to disable all write operations. In this mode:
  14. - Tools that modify Asana data (create, update, delete) will be disabled
  15. - The `create-task` prompt will be disabled
  16. - Only read operations will be available
  17. This is useful for testing or when you want to ensure no changes can be made to your Asana workspace.
  18. ## Usage
  19. In the AI tool of your choice (ex: Claude Desktop) ask something about asana tasks, projects, workspaces, and/or comments. Mentioning the word "asana" will increase the chance of having the LLM pick the right tool.
  20. Example:
  21. > How many unfinished asana tasks do we have in our Sprint 30 project?
  22. Another example:
  23. ![Claude Desktop Example](https://raw.githubusercontent.com/roychri/mcp-server-asana/main/mcp-server-asana-claude-example.png)
  24. ## Tools
  25. 1. `asana_list_workspaces`
  26. * List all available workspaces in Asana
  27. * Optional input:
  28. * opt_fields (string): Comma-separated list of optional fields to include
  29. * Returns: List of workspaces
  30. 2. `asana_search_projects`
  31. * Search for projects in Asana using name pattern matching
  32. * Required input:
  33. * workspace (string): The workspace to search in
  34. * name_pattern (string): Regular expression pattern to match project names
  35. * Optional input:
  36. * archived (boolean): Only return archived projects (default: false)
  37. * opt_fields (string): Comma-separated list of optional fields to include
  38. * Returns: List of matching projects
  39. 3. `asana_search_tasks`
  40. * Search tasks in a workspace with advanced filtering options
  41. * Required input:
  42. * workspace (string): The workspace to search in
  43. * Optional input:
  44. * text (string): Text to search for in task names and descriptions
  45. * resource_subtype (string): Filter by task subtype (e.g. milestone)
  46. * completed (boolean): Filter for completed tasks
  47. * is_subtask (boolean): Filter for subtasks
  48. * has_attachment (boolean): Filter for tasks with attachments
  49. * is_blocked (boolean): Filter for tasks with incomplete dependencies
  50. * is_blocking (boolean): Filter for incomplete tasks with dependents
  51. * assignee, projects, sections, tags, teams, and many other advanced filters
  52. * sort_by (string): Sort by due_date, created_at, completed_at, likes, modified_at (default: modified_at)
  53. * sort_ascending (boolean): Sort in ascending order (default: false)
  54. * opt_fields (string): Comma-separated list of optional fields to include
  55. * custom_fields (object): Object containing custom field filters
  56. * Returns: List of matching tasks
  57. 4. `asana_get_task`
  58. * Get detailed information about a specific task
  59. * Required input:
  60. * task_id (string): The task ID to retrieve
  61. * Optional input:
  62. * opt_fields (string): Comma-separated list of optional fields to include
  63. * Returns: Detailed task information
  64. 5. `asana_create_task`
  65. * Create a new task in a project
  66. * Required input:
  67. * project_id (string): The project to create the task in
  68. * name (string): Name of the task
  69. * Optional input:
  70. * notes (string): Description of the task
  71. * html_notes (string): HTML-like formatted description of the task
  72. * due_on (string): Due date in YYYY-MM-DD format
  73. * assignee (string): Assignee (can be 'me' or a user ID)
  74. * followers (array of strings): Array of user IDs to add as followers
  75. * parent (string): The parent task ID to set this task under
  76. * projects (array of strings): Array of project IDs to add this task to
  77. * resource_subtype (string): The type of the task (default_task or milestone)
  78. * custom_fields (object): Object mapping custom field GID strings to their values
  79. * Returns: Created task information
  80. 6. `asana_get_task_stories`
  81. * Get comments and stories for a specific task
  82. * Required input:
  83. * task_id (string): The task ID to get stories for
  84. * Optional input:
  85. * opt_fields (string): Comma-separated list of optional fields to include
  86. * Returns: List of task stories/comments
  87. 7. `asana_update_task`
  88. * Update an existing task's details
  89. * Required input:
  90. * task_id (string): The task ID to update
  91. * Optional input:
  92. * name (string): New name for the task
  93. * notes (string): New description for the task
  94. * html_notes (string): HTML-like formatted description of the task (subset of HTML tags supported)
  95. * due_on (string): New due date in YYYY-MM-DD format
  96. * assignee (string): New assignee (can be 'me' or a user ID)
  97. * followers (array): Array of user IDs to add as followers
  98. * parent (string): The parent task ID to move this task under
  99. * completed (boolean): Mark task as completed or not
  100. * resource_subtype (string): The type of the task (default_task or milestone)
  101. * custom_fields (object): Object mapping custom field GID strings to their values
  102. * Returns: Updated task information
  103. 8. `asana_get_project`
  104. * Get detailed information about a specific project
  105. * Required input:
  106. * project_id (string): The project ID to retrieve
  107. * Optional input:
  108. * opt_fields (string): Comma-separated list of optional fields to include
  109. * Returns: Detailed project information
  110. 9. `asana_get_project_task_counts`
  111. * Get the number of tasks in a project
  112. * Required input:
  113. * project_id (string): The project ID to get task counts for
  114. * Optional input:
  115. * opt_fields (string): Comma-separated list of optional fields to include
  116. * Returns: Task count information
  117. 10. `asana_get_project_sections`
  118. * Get sections in a project
  119. * Required input:
  120. * project_id (string): The project ID to get sections for
  121. * Optional input:
  122. * opt_fields (string): Comma-separated list of optional fields to include
  123. * Returns: List of project sections
  124. 11. `asana_create_task_story`
  125. * Create a comment or story on a task
  126. * Required input:
  127. * task_id (string): The task ID to add the story to
  128. * text (string): The text content of the story/comment
  129. * Optional input:
  130. * opt_fields (string): Comma-separated list of optional fields to include
  131. * Returns: Created story information
  132. 12. `asana_add_task_dependencies`
  133. * Set dependencies for a task
  134. * Required input:
  135. * task_id (string): The task ID to add dependencies to
  136. * dependencies (array of strings): Array of task IDs that this task depends on
  137. * Returns: Updated task dependencies
  138. 13. `asana_add_task_dependents`
  139. * Set dependents for a task (tasks that depend on this task)
  140. * Required input:
  141. * task_id (string): The task ID to add dependents to
  142. * dependents (array of strings): Array of task IDs that depend on this task
  143. * Returns: Updated task dependents
  144. 14. `asana_create_subtask`
  145. * Create a new subtask for an existing task
  146. * Required input:
  147. * parent_task_id (string): The parent task ID to create the subtask under
  148. * name (string): Name of the subtask
  149. * Optional input:
  150. * notes (string): Description of the subtask
  151. * due_on (string): Due date in YYYY-MM-DD format
  152. * assignee (string): Assignee (can be 'me' or a user ID)
  153. * opt_fields (string): Comma-separated list of optional fields to include
  154. * Returns: Created subtask information
  155. 15. `asana_get_multiple_tasks_by_gid`
  156. * Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)
  157. * Required input:
  158. * task_ids (array of strings or comma-separated string): Task GIDs to retrieve (max 25)
  159. * Optional input:
  160. * opt_fields (string): Comma-separated list of optional fields to include
  161. * Returns: List of detailed task information
  162. 16. `asana_get_project_status`
  163. * Get a project status update
  164. * Required input:
  165. * project_status_gid (string): The project status GID to retrieve
  166. * Optional input:
  167. * opt_fields (string): Comma-separated list of optional fields to include
  168. * Returns: Project status information
  169. 17. `asana_get_project_statuses`
  170. * Get all status updates for a project
  171. * Required input:
  172. * project_gid (string): The project GID to get statuses for
  173. * Optional input:
  174. * limit (number): Results per page (1-100)
  175. * offset (string): Pagination offset token
  176. * opt_fields (string): Comma-separated list of optional fields to include
  177. * Returns: List of project status updates
  178. 18. `asana_create_project_status`
  179. * Create a new status update for a project
  180. * Required input:
  181. * project_gid (string): The project GID to create the status for
  182. * text (string): The text content of the status update
  183. * Optional input:
  184. * color (string): The color of the status (green, yellow, red)
  185. * title (string): The title of the status update
  186. * html_text (string): HTML formatted text for the status update
  187. * opt_fields (string): Comma-separated list of optional fields to include
  188. * Returns: Created project status information
  189. 19. `asana_delete_project_status`
  190. * Delete a project status update
  191. * Required input:
  192. * project_status_gid (string): The project status GID to delete
  193. * Returns: Deletion confirmation
  194. 20. `asana_set_parent_for_task`
  195. * Set the parent of a task and position the subtask within the other subtasks of that parent
  196. * Required input:
  197. * task_id (string): The task ID to operate on
  198. * data (object):
  199. * parent (string): The new parent of the task, or null for no parent
  200. * Optional input:
  201. * insert_after (string): A subtask of the parent to insert the task after, or null to insert at the beginning of the list
  202. * insert_before (string): A subtask of the parent to insert the task before, or null to insert at the end of the list
  203. * opt_fields (string): Comma-separated list of optional fields to include
  204. * Returns: Updated task information
  205. 21. `asana_get_tag`
  206. * Get detailed information about a specific tag
  207. * Required input:
  208. * tag_gid (string): Globally unique identifier for the tag
  209. * Optional input:
  210. * opt_fields (string): Comma-separated list of optional fields to include
  211. * Returns: Detailed tag information
  212. 22. `asana_get_tags_for_task`
  213. * Get a task's tags
  214. * Required input:
  215. * task_gid (string): The task to operate on
  216. * Optional input:
  217. * limit (number): Results per page. The number of objects to return per page. The value must be between 1 and 100.
  218. * offset (string): Offset token. An offset to the next page returned by the API.
  219. * opt_fields (string): Comma-separated list of optional fields to include
  220. * Returns: List of tags associated with the task
  221. 23. `asana_get_tasks_for_tag`
  222. * Get tasks for a specific tag
  223. * Required input:
  224. * tag_gid (string): The tag GID to retrieve tasks for
  225. * Optional input:
  226. * opt_fields (string): Comma-separated list of optional fields to include
  227. * opt_pretty (boolean): Provides the response in a 'pretty' format
  228. * limit (integer): The number of objects to return per page. The value must be between 1 and 100.
  229. * offset (string): An offset to the next page returned by the API.
  230. * Returns: List of tasks for the specified tag
  231. 24. `asana_get_tags_for_workspace`
  232. * Get tags in a workspace
  233. * Required input:
  234. * workspace_gid (string): Globally unique identifier for the workspace or organization
  235. * Optional input:
  236. * limit (integer): Results per page. The number of objects to return per page. The value must be between 1 and 100.
  237. * offset (string): Offset token. An offset to the next page returned by the API.
  238. * opt_fields (string): Comma-separated list of optional fields to include
  239. * Returns: List of tags in the workspace
  240. 25. `asana_update_tag`
  241. * Update an existing tag
  242. * Required input:
  243. * tag_gid (string): Globally unique identifier for the tag
  244. * Optional input:
  245. * name (string): Name of the tag
  246. * color (string): Color of the tag. Can be one of: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-brown, light-orange, light-purple, light-warm-gray
  247. * notes (string): Notes about the tag
  248. * opt_fields (string): Comma-separated list of optional fields to include
  249. * Returns: Updated tag information
  250. 26. `asana_delete_tag`
  251. * Delete a tag
  252. * Required input:
  253. * tag_gid (string): Globally unique identifier for the tag
  254. * Returns: Deletion confirmation
  255. 27. `asana_create_tag_for_workspace`
  256. * Create a new tag in a workspace
  257. * Required input:
  258. * workspace_gid (string): Globally unique identifier for the workspace or organization
  259. * name (string): Name of the tag
  260. * Optional input:
  261. * color (string): Color of the tag. Can be one of: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-brown, light-orange, light-purple, light-warm-gray
  262. * notes (string): Notes about the tag
  263. * opt_fields (string): Comma-separated list of optional fields to include
  264. * Returns: Created tag information
  265. 28. `asana_add_tag_to_task`
  266. * Add a tag to a task
  267. * Required input:
  268. * task_gid (string): The task GID to add the tag to
  269. * tag_gid (string): The tag GID to add to the task
  270. * Returns: Success response
  271. 29. `asana_remove_tag_from_task`
  272. * Remove a tag from a task
  273. * Required input:
  274. * task_gid (string): The task GID to remove the tag from
  275. * tag_gid (string): The tag GID to remove from the task
  276. * Returns: Success response
  277. 30. `asana_add_project_to_task`
  278. * Add an existing task to a project
  279. * Required input:
  280. * task_id (string): The task ID to add to the project
  281. * project_id (string): The project ID to add the task to
  282. * Optional input:
  283. * section (string): The section ID to add the task to within the project
  284. * insert_after (string): A task ID to insert this task after. At most one of insert_before, insert_after, or section should be specified.
  285. * insert_before (string): A task ID to insert this task before. At most one of insert_before, insert_after, or section should be specified.
  286. * Returns: Success message confirming the task was added to the project
  287. * Notes: If no positioning arguments are given, the task will be added to the end of the project
  288. 31. `asana_remove_project_from_task`
  289. * Remove a task from a project
  290. * Required input:
  291. * task_id (string): The task ID to remove from the project
  292. * project_id (string): The project ID to remove the task from
  293. * Returns: Success message confirming the task was removed from the project
  294. * Notes: The task will still exist in the system, but it will not be in the project anymore
  295. 32. `asana_delete_task`
  296. * Delete a task permanently
  297. * Required input:
  298. * task_id (string): The task ID to delete
  299. * Returns: Success message confirming the task was deleted
  300. * Notes: This action cannot be undone. The task will be permanently removed.
  301. 33. `asana_create_project`
  302. * Create a new project in a workspace or team
  303. * Required input:
  304. * workspace (string): The workspace GID to create the project in
  305. * name (string): Name of the project
  306. * Optional input:
  307. * team (string): The team GID (required for organization workspaces)
  308. * notes (string): Description or notes for the project
  309. * color (string): Color of the project (e.g., dark-pink, dark-green, light-blue)
  310. * privacy_setting (string): Privacy setting (public_to_workspace, private_to_team, private)
  311. * default_view (string): Default view (list, board, calendar, timeline)
  312. * opt_fields (string): Comma-separated list of optional fields to include
  313. * Returns: The created project object
  314. 34. `asana_update_project`
  315. * Update a project's details (name, description, etc.)
  316. * Required input:
  317. * project_id (string): The project GID to update
  318. * Optional input:
  319. * name (string): New name for the project
  320. * notes (string): New plain text description for the project
  321. * html_notes (string): New HTML formatted description (must be valid Asana XML)
  322. * color (string): Color of the project (e.g., dark-pink, dark-green, light-blue)
  323. * privacy_setting (string): Privacy setting (public_to_workspace, private_to_team, private)
  324. * opt_fields (string): Comma-separated list of optional fields to include
  325. * Returns: Updated project information
  326. 35. `asana_create_section`
  327. * Create a new section in a project
  328. * Required input:
  329. * project_id (string): The project GID to create the section in
  330. * name (string): Name of the new section
  331. * Optional input:
  332. * opt_fields (string): Comma-separated list of optional fields to include
  333. * Returns: Created section information
  334. 36. `asana_update_section`
  335. * Update a section (rename it)
  336. * Required input:
  337. * section_id (string): The section GID to update
  338. * name (string): New name for the section
  339. * Optional input:
  340. * opt_fields (string): Comma-separated list of optional fields to include
  341. * Returns: Updated section information
  342. 37. `asana_delete_section`
  343. * Delete a section from a project
  344. * Required input:
  345. * section_id (string): The section GID to delete
  346. * Returns: Deletion confirmation
  347. 38. `asana_add_task_to_section`
  348. * Move a task to a section within its project
  349. * Required input:
  350. * section_id (string): The section GID to add the task to
  351. * task_id (string): The task GID to move
  352. * Optional input:
  353. * insert_before (string): A task GID to insert the task before
  354. * insert_after (string): A task GID to insert the task after
  355. * Returns: Success confirmation
  356. 39. `asana_get_subtasks`
  357. * Get all subtasks of a given task. Returns a compact representation of each subtask.
  358. * Required input:
  359. * task_gid (string): The GID of the parent task
  360. * Optional input:
  361. * opt_fields (string): Comma-separated list of optional fields to include (e.g. 'name,completed,assignee,due_on')
  362. * Returns: Array of subtask objects
  363. 40. `asana_get_tasks_for_project`
  364. * Get all tasks in a project. Use this instead of search_tasks when you need to list tasks in a specific project. Works on free Asana plans (unlike search_tasks which requires premium). Supports pagination and optional field selection.
  365. * Required input:
  366. * project_id (string): The project GID to get tasks for
  367. * Optional input:
  368. * opt_fields (string): Comma-separated list of optional fields to include
  369. * limit (number): Results per page (1-100)
  370. * offset (string): Pagination offset token from a previous response
  371. * Returns: Array of task objects
  372. 41. `asana_get_my_tasks`
  373. * Get tasks from the authenticated user's 'My Tasks' list in a workspace
  374. * Required input:
  375. * workspace (string): The workspace GID to get My Tasks from
  376. * Optional input:
  377. * opt_fields (string): Comma-separated list of optional fields to include
  378. * completed_since (string): Only return tasks completed since this time (ISO 8601). Use 'now' to only return incomplete tasks.
  379. * Returns: List of tasks from the user's My Tasks list
  380. ## Prompts
  381. 1. `task-summary`
  382. * Get a summary and status update for a task based on its notes, custom fields and comments
  383. * Required input:
  384. * task_id (string): The task ID to get summary for
  385. * Returns: A detailed prompt with instructions for generating a task summary
  386. 2. `task-completeness`
  387. * Analyze if a task description contains all necessary details for completion
  388. * Required input:
  389. * task_id (string): The task ID or URL to analyze
  390. * Returns: A detailed prompt with instructions for analyzing task completeness
  391. 3. `create-task`
  392. * Create a new task with specified details
  393. * Required input:
  394. * project_name (string): The name of the Asana project where the task should be created
  395. * title (string): The title of the task
  396. * Optional input:
  397. * notes (string): Notes or description for the task
  398. * due_date (string): Due date for the task (YYYY-MM-DD format)
  399. * Returns: A detailed prompt with instructions for creating a comprehensive task
  400. ## Resources
  401. 1. Workspaces - `asana://workspace/{workspace_gid}`
  402. * Representation of Asana workspaces as resources
  403. * Each workspace is exposed as a separate resource
  404. * URI Format: `asana://workspace/{workspace_gid}`
  405. * Returns: JSON object with workspace details including:
  406. * `name`: Workspace name (string)
  407. * `id`: Workspace global ID (string)
  408. * `type`: Resource type (string)
  409. * `is_organization`: Whether the workspace is an organization (boolean)
  410. * `email_domains`: List of email domains associated with the workspace (string[])
  411. * Mime Type: `application/json`
  412. 2. Projects - `asana://project/{project_gid}`
  413. * Template resource for retrieving project details by GID
  414. * URI Format: `asana://project/{project_gid}`
  415. * Returns: JSON object with project details including:
  416. * `name`: Project name (string)
  417. * `id`: Project global ID (string)
  418. * `type`: Resource type (string)
  419. * `archived`: Whether the project is archived (boolean)
  420. * `public`: Whether the project is public (boolean)
  421. * `notes`: Project description/notes (string)
  422. * `color`: Project color (string)
  423. * `default_view`: Default view type (string)
  424. * `due_date`, `due_on`, `start_on`: Project date information (string)
  425. * `workspace`: Object containing workspace information
  426. * `team`: Object containing team information
  427. * `sections`: Array of section objects in the project
  428. * `custom_fields`: Array of custom field definitions for the project
  429. * Mime Type: `application/json`
  430. ## Setup
  431. 1. **Create an Asana account**:
  432. - Visit the [Asana](https://www.asana.com).
  433. - Click "Sign up".
  434. 2. **Retrieve the Asana Access Token**:
  435. - You can generate a personal access token from the Asana developer console.
  436. - https://app.asana.com/0/my-apps
  437. - More details here: https://developers.asana.com/docs/personal-access-token
  438. 3. **Installation Options**:
  439. ### For Claude Desktop:
  440. Add the following to your `claude_desktop_config.json`:
  441. ```json
  442. {
  443. "mcpServers": {
  444. "asana": {
  445. "command": "npx",
  446. "args": ["-y", "@roychri/mcp-server-asana"],
  447. "env": {
  448. "ASANA_ACCESS_TOKEN": "your-asana-access-token"
  449. }
  450. }
  451. }
  452. }
  453. ```
  454. ### For Claude Code:
  455. Use the following command to install and configure the MCP server:
  456. ```bash
  457. claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana
  458. ```
  459. Replace `<TOKEN>` with your Asana access token.
  460. ### For Codex CLI:
  461. Add the following to your `~/.codex/config.toml`:
  462. ```toml
  463. [mcp_servers.asana]
  464. command = "npx"
  465. args = [
  466. "-y", "@roychri/mcp-server-asana"
  467. ]
  468. env = {ASANA_ACCESS_TOKEN= "<TOKEN>"}
  469. ```
  470. Replace `<TOKEN>` with your Asana access token.
  471. If you want to install the beta version (not yet released), you can use:
  472. * `@roychri/mcp-server-asana@beta`
  473. You can find the current beta release, if any, with either:
  474. 1. https://www.npmjs.com/package/@roychri/mcp-server-asana?activeTab=versions
  475. 2. `npm dist-tag ls @roychri/mcp-server-asana`
  476. ## Troubleshooting
  477. If you encounter permission errors:
  478. 1. Ensure the asana plan you have allows API access
  479. 2. Confirm the access token and configuration are correctly set in `claude_desktop_config.json`.
  480. ## Contributing
  481. Clone this repo and start hacking.
  482. ### Test it locally with the MCP Inspector
  483. If you want to test your changes, you can use the MCP Inspector like this:
  484. ```bash
  485. npm run inspector
  486. ```
  487. This will expose the client to port `5173` and server to port `3000`.
  488. If those ports are already used by something else, you can use:
  489. ```bash
  490. CLIENT_PORT=5009 SERVER_PORT=3009 npm run inspector
  491. ```
  492. ## License
  493. This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.