`asana_create_task`

Pack: asana · Endpoint: https://gateway.pipeworx.io/asana/mcp

Create a new task in a project. Returns task ID, name, and permalink. Requires project ID and task name.

Parameters

Name	Type	Required	Description
`name`	string	yes	Task name
`projects`	string	no	Comma-separated project GIDs to add the task to
`workspace`	string	no	Workspace GID (auto-resolved if omitted)
`notes`	string	no	Task description / notes
`due_on`	string	no	Due date in YYYY-MM-DD format
`assignee`	string	no	Assignee GID or email address

Example call

Arguments

{
  "name": "Design landing page"
}

curl

curl -X POST https://gateway.pipeworx.io/asana/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"asana_create_task","arguments":{"name":"Design landing page"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('asana_create_task', {
  "name": "Design landing page"
});

More examples

{
  "name": "Review Q4 budget",
  "projects": "1234567890123456,9876543210987654",
  "assignee": "[email protected]",
  "due_on": "2024-12-31",
  "notes": "Include cost analysis"
}

Response shape

Field	Type	Description
`gid`	string	Task GID
`name`	string	Task name
`permalink_url`	string	Task permalink URL
`notes`	string	Task notes
`completed`	boolean	Task completion status
`due_on`	string	Due date in YYYY-MM-DD format
`assignee`	string	Assignee identifier
`projects`	array	Projects task is added to

Full JSON Schema

{
  "type": "object",
  "properties": {
    "gid": {
      "type": "string",
      "description": "Task GID"
    },
    "name": {
      "type": "string",
      "description": "Task name"
    },
    "permalink_url": {
      "type": "string",
      "description": "Task permalink URL"
    },
    "notes": {
      "type": "string",
      "description": "Task notes"
    },
    "completed": {
      "type": "boolean",
      "description": "Task completion status"
    },
    "due_on": {
      "type": "string",
      "description": "Due date in YYYY-MM-DD format"
    },
    "assignee": {
      "type": "string",
      "description": "Assignee identifier"
    },
    "projects": {
      "type": "array",
      "description": "Projects task is added to",
      "items": {
        "type": "string"
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "asana": {
      "url": "https://gateway.pipeworx.io/asana/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

asana_create_task