Get a task

Read one task with its notes and checklist.

MCP tool habitica_read → get_task

read

Returns the title, notes, difficulty, tags, repeat settings for a daily or due date for a to-do, and every checklist item with its ID and state. Use it before editing a checklist.

Parameters

Parameters: get_task
NameTypeDescription
task_id string required string Task ID from list_tasks.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "habitica_read",
    "arguments": {
      "operation": "get_task",
      "arguments": {
        "task_id": "task_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "task_id": "4e0b9c12-77a3-4d0f-8b1e-2a6f9d3c5e70",
    "type": "todo",
    "title": "Move apartment",
    "difficulty": "hard",
    "due": "2026-11-15",
    "checklist": [
      {
        "item_id": "c1",
        "text": "Book the movers",
        "done": true
      },
      {
        "item_id": "c2",
        "text": "Cancel electricity",
        "done": false
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.