name: asana
description: Enables Claude to create, manage, and track projects and tasks in Asana via Playwright MCP
category: productivity

Asana Skill

Overview

Claude can manage your Asana workspace to create projects, organize tasks, track progress, and coordinate team work. Supports multiple views including list, board, timeline, and calendar.

Quick Install

curl -sSL https://canifi.com/skills/asana/install.sh | bash

Or manually:

cp -r skills/asana ~/.canifi/skills/

Setup

Configure via canifi-env:

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set ASANA_EMAIL "[email protected]"

Privacy & Authentication

Your credentials, your choice. Canifi LifeOS respects your privacy.

Option 1: Manual Browser Login (Recommended)

If you prefer not to share credentials with Claude Code:
1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

If you're comfortable sharing credentials, you can store them locally:

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

Capabilities

• Create and manage projects
• Add and organize tasks
• Create subtasks
• Set due dates and assignees
• Track project progress
• Use custom fields
• Add task dependencies
• View timeline/Gantt
• Create milestones
• Add comments and attachments
• Use project templates
• Generate status reports

Usage Examples

Example 1: Create Task

User: "Add a task 'Prepare presentation' to the Marketing project"
Claude: Opens project, creates task with title.
        Confirms: "Task 'Prepare presentation' added to Marketing"

Example 2: View Project Status

User: "What's the status of the Product Launch project?"
Claude: Opens project, analyzes tasks.
        Reports: "Product Launch: 65% complete. 13 tasks done,
        7 in progress, 5 pending. Next milestone: Beta Release (3 days)"

Example 3: Assign Task

User: "Assign the UX review task to Sarah with Friday deadline"
Claude: Finds task, assigns to Sarah, sets due date.
        Confirms: "Assigned to Sarah, due Friday"

Example 4: Create Project

User: "Create a new project for the website redesign"
Claude: Creates project "Website Redesign" with sections.
        Returns: "Project created with default sections"

Authentication Flow

1. Claude navigates to app.asana.com via Playwright MCP
2. Enters ASANA_EMAIL for authentication
3. Handles 2FA if required (notifies user via iMessage)
4. Maintains session for project operations

Selectors Reference

// Sidebar
'.SidebarWorkspaceDropdownButton'

// Project list
'.SidebarNavigationLinkList'

// Task list
'.TaskList'

// Task row
'.TaskRow'

// Add task button
'.AddTaskButton'

// Task name input
'.TaskName-input'

// Assignee
'.TaskAssigneeField'

// Due date
'.DueDateField'

// Project header
'.ProjectHeader'

// Sections
'.TaskListSectionRow'

// Timeline view
'.Timeline'

Error Handling

• Login Failed: Retry 3 times, notify user via iMessage
• Session Expired: Re-authenticate automatically
• Project Not Found: List available projects, ask user
• Task Create Failed: Retry, verify project access
• Assignment Failed: Verify member is in workspace
• Permission Denied: Notify user of access issue

Self-Improvement Instructions

When you learn a better way to accomplish a task with Asana:
1. Document the improvement in your response
2. Suggest updating this skill file with the new approach
3. Include specific project management workflows
4. Note useful custom field configurations

Notes

• Multiple views: list, board, timeline, calendar
• Custom fields for project-specific data
• Rules for automation
• Forms for task intake
• Goals for OKR tracking
• Portfolios for project oversight
• Workload view for capacity planning
• Templates for repeatable projects