Score a habit or tick a daily
Tick a daily or to-do, or score a habit up or down.
MCP tool habitica_write → score_task
write
Applies the same result as clicking the task in Habitica and returns the new streak or completion state. Scoring up on a habit counts toward your rewards. It changes only your own account and a second call reverses it, so it does not ask for OK by default.
Parameters
| Name | Type | Description |
|---|---|---|
| task_id string required | string | Task ID from list_tasks. |
| direction string required | string | One of: up, down. A daily or to-do uses up to tick it and down to untick it. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "habitica_write",
"arguments": {
"operation": "score_task",
"arguments": {
"task_id": "b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11",
"direction": "up"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": "b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11",
"direction": "up",
"completed": true,
"streak": 13
},
"isError": false
}