Connect Habitica to Your AI Agent

Turn your plans into personal tasks and use the correct task action to record progress.

Try a Habitica Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Habitica

Create a Checklist To-Do

Turn supplied steps into a to-do with a checklist and due date.

/oo Habitica: Create a Habitica to-do titled “[task title]” due [date] with checklist steps [steps] and notes [notes]. Leave it incomplete.

Record a Completed Task

Read the selected task and score it upward to record completion or positive progress.

/oo Habitica: Read Habitica task [task ID or alias]. I completed it; score it up once and show the resulting progress.

Start Working with Habitica

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Habitica

Connect your Habitica API Token, User ID, and required client identifier.
Connect Habitica →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Habitica account credentials and an X-Client value following the creator-user-ID and app-name format.
Choose habit, daily, to-do, or reward when creating a task. Scoring changes task progress and game values.

Habitica Tools

Habitica operations read your profile and tasks, create or update tasks, score them, and manage task tags.

Personal Tasks and Progress

List or read tasks, create and revise them, score progress, or delete selected tasks.

Task Tags

List, create, rename, or delete tags used to organize tasks.

11 tools

Get User Profile

Get the authenticated Habitica user's profile with optional userFields filtering.

habitica.get_user_profile

List My Tasks

List the authenticated Habitica user's tasks with optional type and dueDate filters.

habitica.list_my_tasks

Get Task

Get one Habitica task by task ID or alias.

habitica.get_task

Create Task

Create one new personal Habitica task from a single JSON task object.

habitica.create_task

Update Task

Update one Habitica task by task ID or alias.

habitica.update_task

Delete Task

Delete one Habitica task by task ID or alias.

habitica.delete_task

Score Task

Score one Habitica task in the up or down direction.

habitica.score_task

List Tags

List the authenticated Habitica user's tags.

habitica.list_tags

Create Tag

Create one new Habitica tag.

habitica.create_tag

Update Tag

Update one Habitica tag by tag ID.

habitica.update_tag

Delete Tag

Delete one Habitica tag by tag ID.

habitica.delete_tag

Frequently Asked Questions

Can I create a daily rather than a to-do?

Yes. Specify the daily type and its repeat pattern or interval. A to-do can instead include a due date and checklist.

How do I record completion?

Identify the task and request upward scoring when appropriate. Scoring is a dedicated action and can affect game values; editing text is a separate operation.

Does updating a checklist preserve its current items?

The supplied checklist replaces the task’s checklist. Read the task and include all items you want to keep.