Skip to main content

​
list_tasks

List tasks for a project. Returns task ID, title, status, priority, and description.

​
Parameters

​
project_id
string
Project ID (auto-detected from working directory if omitted)
​
status
string
Filter by status: todo, in_progress, or done. Omit to return all tasks.
​
global
boolean
Set to true to list global planner tasks instead of project tasks

​
Returns

​
tasks
array
Array of task objects with ID, status, priority, title, and description preview

​
Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_tasks",
    "arguments": {
      "status": "in_progress"
    }
  }
}
Response: 
Tasks (2):
  #42 [in_progress] (high) Implement user authentication [feature]
    Add OAuth2 support for Google and GitHub login...
  #38 [in_progress] (medium) Fix navigation bug [bug]
    Navigation breaks when user clicks back button...

​
get_task

Get full details of a task by ID, including notes and attachments.

​
Parameters

​
task_id
integer
required
Task ID

​
Returns

​
id
integer
Task ID
​
title
string
Task title
​
status
string
Task status: todo, in_progress, or done
​
priority
integer
Priority level (0=none, 1=low, 2=medium, 3=high, 4=urgent)
​
description
string
Full task description
​
labels
array
Array of label strings
​
notes
array
Array of task notes with timestamps

​
Example

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_task",
    "arguments": {
      "task_id": 42
    }
  }
}

​
create_task

Create a new task in a project.

​
Parameters

​
title
string
required
Task title
​
description
string
Task description (optional)
​
project_id
string
Project ID (auto-detected if omitted)
​
priority
integer
Priority: 0=none, 1=low, 2=medium, 3=high, 4=urgent (default: 0)
​
labels
array
Array of label strings (e.g. “bug”, “feature”, “refactor”)
​
global
boolean
Set to true to create a global planner task (visible on home board)

​
Returns

Confirmation message with the created task ID.

​
Example

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_task",
    "arguments": {
      "title": "Add dark mode support",
      "description": "Implement dark mode theme with user preference toggle",
      "priority": 3,
      "labels": ["feature", "ui"]
    }
  }
}
Response: 
Created task #45: Add dark mode support

​
update_task

Update a task’s fields (status, priority, title, description, labels).

​
Parameters

​
task_id
integer
required
Task ID
​
status
string
New status: todo, in_progress, or done
​
priority
integer
New priority (0-4)
​
title
string
New title
​
description
string
New description
​
labels
array
New labels array (replaces existing labels)

​
Returns

Confirmation message listing the updated fields.

​
Example

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "update_task",
    "arguments": {
      "task_id": 42,
      "status": "done"
    }
  }
}
Response: 
Updated task #42: status → done

​
add_task_note

Add a note/comment to a task. Use this to log progress, decisions, or context.

​
Parameters

​
task_id
integer
required
Task ID
​
content
string
required
Note content
​
session_id
string
Claude session ID (auto-detected if omitted)

​
Returns

Confirmation message.

​
Example

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_task_note",
    "arguments": {
      "task_id": 42,
      "content": "Implemented OAuth2 flow, testing with Google provider"
    }
  }
}
Response: 
Added note to task #42

​
list_task_notes

List all notes for a task.

​
Parameters

​
task_id
integer
required
Task ID

​
Returns

Formatted list of notes with timestamps and source information.

​
Example

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "list_task_notes",
    "arguments": {
      "task_id": 42
    }
  }
}
Response: 
Notes for task #42 (3):
  [Mar 4, 10:30] (claude) Started implementing OAuth2 flow
  [Mar 4, 11:45] (claude) Implemented OAuth2 flow, testing with Google provider
  [Mar 4, 14:20] (user) Approved for production

Build docs developers (and LLMs) love

Get started for freeTalk to us