|
| 1 | +--- |
| 2 | +title: Asana |
| 3 | +description: Interact with Asana |
| 4 | +--- |
| 5 | + |
| 6 | +import { BlockInfoCard } from "@/components/ui/block-info-card" |
| 7 | + |
| 8 | +<BlockInfoCard |
| 9 | + type="asana" |
| 10 | + color="#E0E0E0" |
| 11 | + icon={true} |
| 12 | + iconSvg={`<svg className="block-icon" |
| 13 | + |
| 14 | + xmlns='http://www.w3.org/2000/svg' |
| 15 | + |
| 16 | + |
| 17 | + viewBox='781.361 0 944.893 873.377' |
| 18 | + > |
| 19 | + <radialGradient |
| 20 | + id='asana_radial_gradient' |
| 21 | + cx='943.992' |
| 22 | + cy='1221.416' |
| 23 | + r='.663' |
| 24 | + gradientTransform='matrix(944.8934 0 0 -873.3772 -890717.875 1067234.75)' |
| 25 | + gradientUnits='userSpaceOnUse' |
| 26 | + > |
| 27 | + <stop offset='0' stopColor='#ffb900' /> |
| 28 | + <stop offset='.6' stopColor='#f95d8f' /> |
| 29 | + <stop offset='.999' stopColor='#f95353' /> |
| 30 | + </radialGradient> |
| 31 | + <path |
| 32 | + fill='url(#asana_radial_gradient)' |
| 33 | + d='M1520.766 462.371c-113.508 0-205.508 92-205.508 205.488 0 113.499 92 205.518 205.508 205.518 113.489 0 205.488-92.019 205.488-205.518 0-113.488-91.999-205.488-205.488-205.488zm-533.907.01c-113.489.01-205.498 91.99-205.498 205.488 0 113.489 92.009 205.498 205.498 205.498 113.498 0 205.508-92.009 205.508-205.498 0-113.499-92.01-205.488-205.518-205.488h.01zm472.447-256.883c0 113.489-91.999 205.518-205.488 205.518-113.508 0-205.508-92.029-205.508-205.518S1140.31 0 1253.817 0c113.489 0 205.479 92.009 205.479 205.498h.01z' |
| 34 | + /> |
| 35 | + </svg>`} |
| 36 | +/> |
| 37 | + |
| 38 | +## Usage Instructions |
| 39 | + |
| 40 | +Integrate Asana into the workflow. Can read, write, and update tasks. |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +## Tools |
| 45 | + |
| 46 | +### `asana_get_task` |
| 47 | + |
| 48 | +Retrieve a single task by GID or get multiple tasks with filters |
| 49 | + |
| 50 | +#### Input |
| 51 | + |
| 52 | +| Parameter | Type | Required | Description | |
| 53 | +| --------- | ---- | -------- | ----------- | |
| 54 | +| `taskGid` | string | No | The globally unique identifier \(GID\) of the task. If not provided, will get multiple tasks. | |
| 55 | +| `workspace` | string | No | Workspace GID to filter tasks \(required when not using taskGid\) | |
| 56 | +| `project` | string | No | Project GID to filter tasks | |
| 57 | +| `limit` | number | No | Maximum number of tasks to return \(default: 50\) | |
| 58 | + |
| 59 | +#### Output |
| 60 | + |
| 61 | +| Parameter | Type | Description | |
| 62 | +| --------- | ---- | ----------- | |
| 63 | +| `success` | boolean | Operation success status | |
| 64 | +| `output` | object | Single task details or array of tasks, depending on whether taskGid was provided | |
| 65 | + |
| 66 | +### `asana_create_task` |
| 67 | + |
| 68 | +Create a new task in Asana |
| 69 | + |
| 70 | +#### Input |
| 71 | + |
| 72 | +| Parameter | Type | Required | Description | |
| 73 | +| --------- | ---- | -------- | ----------- | |
| 74 | +| `workspace` | string | Yes | Workspace GID where the task will be created | |
| 75 | +| `name` | string | Yes | Name of the task | |
| 76 | +| `notes` | string | No | Notes or description for the task | |
| 77 | +| `assignee` | string | No | User GID to assign the task to | |
| 78 | +| `due_on` | string | No | Due date in YYYY-MM-DD format | |
| 79 | + |
| 80 | +#### Output |
| 81 | + |
| 82 | +| Parameter | Type | Description | |
| 83 | +| --------- | ---- | ----------- | |
| 84 | +| `success` | boolean | Operation success status | |
| 85 | +| `output` | object | Created task details with timestamp, gid, name, notes, and permalink | |
| 86 | + |
| 87 | +### `asana_update_task` |
| 88 | + |
| 89 | +Update an existing task in Asana |
| 90 | + |
| 91 | +#### Input |
| 92 | + |
| 93 | +| Parameter | Type | Required | Description | |
| 94 | +| --------- | ---- | -------- | ----------- | |
| 95 | +| `taskGid` | string | Yes | The globally unique identifier \(GID\) of the task to update | |
| 96 | +| `name` | string | No | Updated name for the task | |
| 97 | +| `notes` | string | No | Updated notes or description for the task | |
| 98 | +| `assignee` | string | No | Updated assignee user GID | |
| 99 | +| `completed` | boolean | No | Mark task as completed or not completed | |
| 100 | +| `due_on` | string | No | Updated due date in YYYY-MM-DD format | |
| 101 | + |
| 102 | +#### Output |
| 103 | + |
| 104 | +| Parameter | Type | Description | |
| 105 | +| --------- | ---- | ----------- | |
| 106 | +| `success` | boolean | Operation success status | |
| 107 | +| `output` | object | Updated task details with timestamp, gid, name, notes, and modified timestamp | |
| 108 | + |
| 109 | +### `asana_get_projects` |
| 110 | + |
| 111 | +Retrieve all projects from an Asana workspace |
| 112 | + |
| 113 | +#### Input |
| 114 | + |
| 115 | +| Parameter | Type | Required | Description | |
| 116 | +| --------- | ---- | -------- | ----------- | |
| 117 | +| `workspace` | string | Yes | Workspace GID to retrieve projects from | |
| 118 | + |
| 119 | +#### Output |
| 120 | + |
| 121 | +| Parameter | Type | Description | |
| 122 | +| --------- | ---- | ----------- | |
| 123 | +| `success` | boolean | Operation success status | |
| 124 | +| `output` | object | List of projects with their gid, name, and resource type | |
| 125 | + |
| 126 | +### `asana_search_tasks` |
| 127 | + |
| 128 | +Search for tasks in an Asana workspace |
| 129 | + |
| 130 | +#### Input |
| 131 | + |
| 132 | +| Parameter | Type | Required | Description | |
| 133 | +| --------- | ---- | -------- | ----------- | |
| 134 | +| `workspace` | string | Yes | Workspace GID to search tasks in | |
| 135 | +| `text` | string | No | Text to search for in task names | |
| 136 | +| `assignee` | string | No | Filter tasks by assignee user GID | |
| 137 | +| `projects` | array | No | Array of project GIDs to filter tasks by | |
| 138 | +| `completed` | boolean | No | Filter by completion status | |
| 139 | + |
| 140 | +#### Output |
| 141 | + |
| 142 | +| Parameter | Type | Description | |
| 143 | +| --------- | ---- | ----------- | |
| 144 | +| `success` | boolean | Operation success status | |
| 145 | +| `output` | object | List of tasks matching the search criteria | |
| 146 | + |
| 147 | +### `asana_add_comment` |
| 148 | + |
| 149 | +Add a comment (story) to an Asana task |
| 150 | + |
| 151 | +#### Input |
| 152 | + |
| 153 | +| Parameter | Type | Required | Description | |
| 154 | +| --------- | ---- | -------- | ----------- | |
| 155 | +| `taskGid` | string | Yes | The globally unique identifier \(GID\) of the task | |
| 156 | +| `text` | string | Yes | The text content of the comment | |
| 157 | + |
| 158 | +#### Output |
| 159 | + |
| 160 | +| Parameter | Type | Description | |
| 161 | +| --------- | ---- | ----------- | |
| 162 | +| `success` | boolean | Operation success status | |
| 163 | +| `output` | object | Comment details including gid, text, created timestamp, and author | |
| 164 | + |
| 165 | + |
| 166 | + |
| 167 | +## Notes |
| 168 | + |
| 169 | +- Category: `tools` |
| 170 | +- Type: `asana` |
0 commit comments