Skip to content

Habitica

What it is

Habitica is an open-source habit-building and productivity app that treats your real life like a game. It transforms your daily tasks and habits into RPG quests, rewarding completion with experience points and gold, and penalizing neglect with health loss.

What problem it solves

Traditional to-do lists often lack the motivation required for long-term habit formation. Habitica solves this by using gamification (rewards, social accountability, and RPG mechanics) to make productivity engaging and fun.

Where it fits in the stack

Category: Service / Productivity

Typical use cases

  • Gamified habit tracking and task management.
  • Team-based productivity challenges.
  • Automated habit scoring via API.

Strengths

  • Highly engaging gamification mechanics.
  • Strong community and social features.
  • Robust API (v3/v4 stable) for third-party integrations.
  • Extensive cross-platform support (Web, iOS, Android).

Limitations

  • Visual style might be too "noisy" for some users.
  • RPG elements can be distracting for pure focus.

When to use it

  • When traditional to-do lists fail to motivate you.
  • When you want to combine habit tracking with social accountability.

When not to use it

  • For strictly professional or minimalist project management.
  • If you find RPG mechanics distracting.

Getting started

Habitica can be used via the web app, mobile apps, or the API. For developers, getting started involves obtaining your User ID and API Token from Settings > API.

Installation (CLI Tool)

You can use the community-maintained CLI to interact with Habitica: 

npm install -g habitica-tools

CLI examples

Check status

habitica status

List tasks

habitica tasks

API examples

Scoring a task (Python)

import requests

USER_ID = 'your-user-id'
API_TOKEN = 'your-api-token'
TASK_ID = 'your-task-id'

headers = {
    'x-api-user': USER_ID,
    'x-api-key': API_TOKEN
}

# Score up a task
response = requests.post(
    f'https://habitica.com/api/v3/tasks/{TASK_ID}/score/up',
    headers=headers
)
print(response.json())

n8n Integration: Automated Habit Scoring

Habitica can be integrated with n8n to automatically score habits based on external events, such as completing a workout logged in a CSV or finishing a deep work session.

Workflow Pattern: Automated Task Scoring

  1. Trigger: Watch for a specific event (e.g., a new row in a Google Sheet or a finished Toggl timer).
  2. HTTP Request Node (Habitica API):
    • Method: POST
    • URL: https://habitica.com/api/v3/tasks/{{$json["task_id"]}}/score/up
    • Headers:
      • x-api-user: {{$env["HABITICA_USER_ID"]}}
      • x-api-key: {{$env["HABITICA_API_TOKEN"]}}
  3. Notification Node: Send a message to Element or Home Assistant confirming the XP gain.

Example: Scoring via Python Sub-process (Code Node)

If you prefer using a specialized Python script within n8n: 

import requests

def score_habit(user_id, api_token, task_id):
    url = f"https://habitica.com/api/v3/tasks/{task_id}/score/up"
    headers = {
        "x-api-user": user_id,
        "x-api-key": api_token,
        "Content-Type": "application/json"
    }
    response = requests.post(url, headers=headers)
    return response.json()

# n8n input mapping
user_id = _input.item.json['USER_ID']
api_token = _input.item.json['API_TOKEN']
task_id = _input.item.json['TASK_ID']

result = score_habit(user_id, api_token, task_id)
return {"json": result}

  • SuperBetter
  • Vikunja — For managing the tasks that aren't gamified.
  • Mealie — For nutritional habit tracking.
  • Grocy — For household chore integration.
  • Home Assistant — For real-life trigger-based scoring.
  • Actual Budget — For financial habit gamification.
  • Authentik — For managing external access to Habitica data tools.
  • n8n — For orchestrating complex automated scoring workflows.

Sources / References

Backlog

  • [x] Perform quarterly technical freshness audit (May 2026).

Contribution Metadata

  • Last reviewed: 2026-05-26
  • Confidence: high