mcp-asana-minimal

Minimal Asana MCP server with essential task operations (11 tools)

A lightweight Model Context Protocol (MCP) server for Asana that provides only the essential task management tools, designed to stay under Cursor's 40-tool limit.

---

Features

- ✅ 11 Essential Tools - Only what you need
- ✅ Personal Access Token Auth - Simple authentication
- ✅ TypeScript - Type-safe implementation
- ✅ Lightweight - Minimal dependencies

---

Tools

1. asana_create_task - Create a new task (supports section parameter)
2. asana_update_task - Update an existing task
3. asana_get_task - Get task details
4. asana_list_tasks - List tasks with filters
5. asana_list_projects - List projects in workspace(s)
6. asana_add_comment - Add comments to tasks
7. asana_create_section - Create a new section in a project (works for both list and board views)
8. asana_list_sections - List all sections in a project
9. asana_add_task_to_section - Move an existing task to a different section/column
10. asana_create_subtask - Create a new subtask within an existing task
11. asana_list_subtasks - List all subtasks of a task

---

Installation

$3

1. Go to: https://app.asana.com/0/my-apps
2. Click "Create New Token" or "Personal Access Token"
3. Give it a name (e.g., "Cursor IDE Integration")
4. Copy the token

$3

``bash
export ASANA_ACCESS_TOKEN="your_token_here"
`

Or add to your shell profile (~/.zshrc or ~/.bashrc):
`bash
echo 'export ASANA_ACCESS_TOKEN="your_token_here"' >> ~/.zshrc
source ~/.zshrc
`

---

Configuration

Add to your ~/.cursor/mcp.json:

`json
{
"mcpServers": {
"asana-minimal": {
"command": "npx",
"args": ["-y", "mcp-asana-minimal"],
"env": {
"ASANA_ACCESS_TOKEN": "${ASANA_ACCESS_TOKEN}"
}
}
}
}
`

---

Usage

After configuration, restart Cursor and use natural language commands:

- "Create a task in Asana called 'Review code'"
- "List my Asana tasks"
- "Update task ABC123 with status completed"
- "Get details for task XYZ789"
- "List all projects in my workspace"
- "Add a comment to task ABC123"

---

Development

$3

`bash
npm install
npm run build
`

$3

`bash
npm start
`

$3

`bash
npm publish --access public
`

---

Tool Details

$3

Create a new task in Asana.

Parameters:
- name (required) - Task name
- notes (optional) - Task description
- workspace (optional) - Workspace GID
- project (optional) - Project GID
- section (optional) - Section GID to add task to (requires project)
- assignee (optional) - Assignee GID
- due_on (optional) - Due date (YYYY-MM-DD)

$3

Update an existing task.

Parameters:
- task_id (required) - Task GID
- name (optional) - New task name
- notes (optional) - New description
- assignee (optional) - Assignee GID (use "none" to unassign)
- due_on (optional) - Due date (use "none" to remove)
- completed (optional) - Mark as completed

$3

Get details of a specific task.

Parameters:
- task_id (required) - Task GID

$3

List tasks with optional filters.

Parameters:
- project (optional) - Filter by project GID
- assignee (optional) - Filter by assignee GID (use "me" for current user)
- workspace (optional) - Filter by workspace GID
- completed (optional) - Filter by completion status
- limit (optional) - Max results (default: 50, max: 100)

$3

List projects in workspace(s).

Parameters:
- workspace (optional) - Filter by workspace GID (lists all accessible projects if not provided)
- archived (optional) - Include archived projects (default: false)
- limit (optional) - Max results (default: 50, max: 100)

$3

Add a comment (story) to an existing task.

Parameters:
- task_id (required) - Task GID
- text (required) - Comment text

$3

Create a new section in an Asana project. Works for both list sections and board columns.

Parameters:
- project (required) - Project GID
- name (required) - Section name

$3

List all sections (list sections or board columns) in a project.

Parameters:
- project (required) - Project GID

$3

Move an existing task to a different section/column.

Parameters:
- task_id (required) - The GID of the task to move
- section_id (required) - The GID of the section to move the task to

$3

Create a new subtask within an existing task.

Parameters:
- parent_task_id (required) - The GID of the parent task
- name (required) - Name of the subtask
- notes (optional) - Subtask description/notes
- assignee (optional) - User GID or "me" to assign the subtask
- due_on (optional) - Due date in YYYY-MM-DD format

$3

List all subtasks of a task.

Parameters:
- task_id` (required) - The GID of the parent task

---

License

MIT

---

Created: 2025-12-11