Habitica

Habitica is the open source habit tracker built as a role playing game. Agents create and score habits, dailies, and to-dos, manage tags and checklists, read character stats and inventory, work with parties, guilds, and challenges, and react to webhook events.

Verified 1 trigger 118 actions API key available

Habitica website Platform Documentation Capability data verified 2026-08-24

A team habit challenge reaches its end date, or a milestone in the source system says a habit was actually kept

Get Challenge and List Challenge Members read who took part, and Get Challenge Member Progress reads each person's copies of the challenge tasks

Export Challenge CSV pulls the leaderboard in Habitica's own format so the standings are auditable rather than reconstructed

The agent verifies the standings against the source system, since a task ticked in Habitica is a claim and not always evidence

Get User confirms the account holds enough gems for the prize that was committed when the challenge was created

The standings and the proposed winner go to the program owner with the evidence attached

The program owner names the winner, and only then does the agent call Select Challenge Winner, which closes the challenge for good

What This Integration Enables

Habitica is a habit tracker built as a role playing game, and that is not a skin over a to-do list. The character's state is an economy with real consequences, which makes it unlike every other task system in this category. Score Task is not a completion flag: it awards or removes experience, gold, mana, and health, advances or breaks a streak, and can level a character up or kill it. It is not reversible by scoring the other way, because scoring down applies a second separate change rather than undoing the first. Run Cron really does apply damage for missed dailies. Revive really does cost a level and a random equipped item. Transfer Gems and the shop operations spend a real balance. There is no read only token; the credential is full account control.

That is the honest frame for automating it, and it is also why it suits agents that know when to stop. FlowRunner agents read tasks, tags, character state, groups, quests, challenges, and shared group tasks, keep team programs organized, assemble standings, and post into party and guild chat. Where a call changes the ledger, human-in-the-loop puts a person in front of it rather than letting a retry apply an effect twice. Every action is built and verified against the Habitica API, including the client header Habitica requires before it will look at credentials at all.

Without FlowRunner

Programs run on volunteer effort Somebody keeps the standings in a spreadsheet until they get busy, and then nobody does

Participation is invisible Whether a challenge is working is a matter of opinion until it is over

Scoring by hand, or not at all Ticking off other people's progress is tedious, so it is done in bursts and inconsistently

With FlowRunner

Standings assembled from the source Progress is read from Habitica and checked against the system that would actually know

Participation is observable Member progress and group task state are read on a schedule and reported while the program can still change

Irreversible calls have a name against them The agent prepares the standings; the person who owns the program decides who wins

Use Case Scenarios

A team habit program with real standings

An operations or people team runs a shared habit program through a Habitica guild. The agent keeps the plumbing straight so nobody has to: Create Challenge Task pushes a new shared habit out to every participant, List Challenge Members and Get Challenge Member Progress read where each person has got to, and Export Challenge CSV produces the standings in Habitica's own export format. The results append to a sheet in Google Sheets and a weekly summary posts to Slack, where the team actually reads things. When the program ends, Unlink All Challenge Tasks detaches everyone's copies so the habits survive the challenge instead of vanishing with it.
Habits scored from evidence rather than from memory

Habitica is at its most useful when the thing being tracked can be observed somewhere else. A daily that says the on call runbook was reviewed, a habit that says the deploy checklist was followed, a to-do that says the monthly report went out. The agent watches the system that would actually know, then calls Score Task when the evidence is unambiguous. Because scoring changes real game state and a re-run applies the effect again, the flow is built to be idempotent by design: it records what it has already scored and reads Get Task before acting. Where the evidence is partial, it does not score. It adds a checklist item or a comment in party chat and lets the person decide, which is the correct answer for a system that has no undo.
Keeping a party from taking real damage

Habitica punishes absence. Missed dailies do damage at the day start, and a group quest loses progress when members stop participating. The agent reads Get User for the people who have opted into this and watches for the pattern that precedes a bad rollover: a stack of dailies untouched with the day start approaching. Rather than scoring anything, it sends the person a note through Send Private Message, or suggests Toggle Sleep, which checks the character into the Inn so missed dailies stop doing damage. Toggle Sleep flips the current state rather than setting it, so the agent reads Get User first and only calls it when the flag disagrees with the intent. The nudge is a nudge. The account holder decides.

Human-in-Loop Highlight

Select Challenge Winner is the operation on this connector that cannot be walked back. It ends a challenge by naming its winner, which awards them the gem prize that was committed out of the creator's balance when the challenge was created. The challenge cannot be reopened, and the prize cannot be reassigned. Everything leading up to it is work an agent should absolutely do: reading every participant's progress, exporting the leaderboard, checking the standings against whatever system would independently confirm them, and noticing the two people who are tied. Deciding who wins a prize paid in real currency is not.

So the agent assembles the case and stops: "The 'Deploy checklist, September' challenge closed last night. Twelve participants. By completed dailies, Priya leads with 21 and Marcus has 20, but three of Marcus's ticks are on days the deploy log shows no release, and Priya missed two days she flagged as leave. The prize is 15 gems, committed at creation. Standings and the CSV export are attached. Who wins?" A person names the winner, the agent calls Select Challenge Winner once, and it posts the result to the guild with Send Group Chat Message. What the agent removed was the tedium of reconstructing the leaderboard. What it did not touch was the decision that spends the prize.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

118 actions

Tasks

List Tasks Returns the authenticated user's tasks. Completed to-dos are excluded unless the filter asks for them, which is the usual reason a report of finished work comes back empty.
Get Task Returns one task by its identifier or its alias, with its checklist, tags, streak, and value.
Create Task Creates a habit, daily, to-do, or reward. The type decides which of the other fields Habitica reads, and fields sent for the wrong type are ignored silently.
Update Task Changes an existing task. Habitica marks both the text and the type required on this route even when neither is changing, so a workflow reads the task first when it does not already hold them.
Score Task Scores a task up or down, which is what completing one means in Habitica. It changes real game state, awarding or removing experience, gold, mana, and health, and it is not reversible by scoring the other way.
Move Task Moves a task to a new position in its list.
Delete Task Permanently deletes a task with its checklist and history. Scoring already applied to the character is not reversed.
Clear Completed To-Dos Removes every completed to-do at once, with no undo and no confirmation. The experience and gold they earned stay with the character; the records do not.
Add Checklist Item Adds an item to a task's checklist, which is how one daily or to-do carries several steps.
Update Checklist Item Changes a checklist item's text or its completed state. Habitica requires the text even when only the tick is changing.
Score Checklist Item Toggles one checklist item without touching the task's own score. Ticking a step is not the same as completing the task, and only the latter awards anything.
Delete Checklist Item Removes one item from a task's checklist.

Character

Get User Returns the authenticated user's full record: stats, class, level, gold, health, mana, preferences, flags, items, and party membership. The read a status workflow starts from.
Update User Writes to the parts of the user record Habitica allows, including profile, preferences, flags, stats, and achievements, sending only the keys that are meant to change.
Get Anonymized User Data Returns the user's data with personal identifiers stripped out. Habitica provides it for export and support requests, so it is the right read when the record leaves the account owner's own systems.
Run Cron Runs Habitica's daily reset: applies damage for missed dailies, resets streaks, and rolls the day over. Habitica does this automatically at the user's day start, so calling it manually applies real damage.
Toggle Sleep Checks the character in or out of the Inn, where missed dailies stop doing damage. It flips the current state rather than setting it, so a workflow reads first and calls only when the flag disagrees.
Cast Skill Casts one of the character's class skills, spending mana. Habitica refuses a skill the character has not unlocked, and only some skills read a target.
Change Class Changes the character's class. Habitica charges gems after the first change and resets allocated stat points, so this spends currency rather than setting a preference.
Disable Classes Turns the class system off for the account, removing skills and stat allocation and returning the character to plain habit tracking.
Allocate Stat Point Spends one unallocated stat point on a chosen attribute.
Allocate All Stat Points Spends every unallocated stat point at once using the character's automatic allocation setting.
Allocate Stat Points In Bulk Spends several stat points in one call, choosing how many go to each attribute.
Revive Brings a dead character back to life, at Habitica's usual death penalty of a level, gold, and a random equipped item. Worth calling only after Get User reports the character is actually dead.
Set Custom Day Start Sets the hour Habitica treats as the start of the user's day, which is when the reset runs and missed dailies do damage.

Account

Get Purchase History Returns the account's purchase history: gems, subscriptions, and anything else bought through Habitica.
Block User Blocks or unblocks another member. It is a toggle, so calling it for somebody already blocked unblocks them.

Shop and Inventory

Buy Item Buys an item from Habitica's shops by its key. The type decides which shop and which currency, and gems cost real currency.
Buy With Hourglass Buys a Mystic Hourglass item, which is how a subscriber spends the hourglasses a subscription earns.
Buy Generic Item Buys an item from the market by key alone, which is Habitica's older single argument purchase route.
Buy Gear Buys a piece of equipment from the market with gold.
Buy Health Potion Buys a health potion with gold and drinks it immediately, restoring health up to the maximum.
Buy Special Item Buys a special item such as a seasonal spell or a gift card.
Buy Quest Scroll Buys a quest scroll with gold, which is what a party then invites its members to.
Buy From Armoire Spends gold on the Enchanted Armoire, which returns a random reward and reports which kind it was.
Buy Mystery Set Claims a subscriber Mystery Item set for a given month.
Open Mystery Item Opens the next unopened subscriber Mystery Item and adds it to the inventory.
Sell Item Sells eggs, hatching potions, or food from the inventory back for gold.
Unequip Items Takes off equipment, with the type choosing whether that means battle gear, the costume, or the pet and mount.
Unlock Item Unlocks purchasable customizations such as hair, skin, and backgrounds with gems, and several can be unlocked in one call.

Content and Status

Get Content Returns Habitica's entire static content catalog with every key, price, and description. It is the lookup the shop operations need and it is large, so a workflow fetches it once and caches it.
Get Server Status Returns whether the Habitica API is up, with its current version. It needs no credentials, which makes it the safe pre-flight before anything that changes game state.
Get World State Returns the shared world's state, including the current world boss and the active seasonal event.

Groups

List Groups Returns the groups the user belongs to or can see. The type is required, so a workflow says which kind it wants.
Get Group Returns one group with its member count, quest state, and chat settings.
Create Group Creates a party or a guild. A party must be private, and a public guild costs gems.
Update Group Changes a group's name, description, leader, or other settings, sending only the keys that are meant to change.
List Group Members Returns the members of a group with their public profile and stats.
List Group Invites Returns the outstanding invitations to a group, meaning people invited who have not yet joined.
Invite To Group Invites people to a group by Habitica user id, by email address, or both.
Join Group Accepts an invitation and joins a group.
Leave Group Leaves a group. Whether the group's challenge tasks stay in the user's own list is an option on the call, so a workflow should set it deliberately.
Reject Group Invite Declines an outstanding invitation to a group.
Remove Group Member Removes a member from a group, or withdraws an invitation that has not been accepted. Only the leader may do it.
Add Group Manager Promotes a member to group manager, which lets them moderate chat and manage the group without being its leader.
Remove Group Manager Demotes a group manager back to an ordinary member.
List Group Plans Returns the group plans the user belongs to. A group plan is Habitica's paid team subscription, which is what unlocks shared group tasks.

Chat

Get Group Chat Returns a group's chat messages, newest first.
Send Group Chat Message Posts a message to a group's chat. The tavern is a public channel read by the whole Habitica community, so a workflow posting there is broadcasting rather than messaging a team.
Like Chat Message Likes a chat message, or removes the like when it is already there. It is a toggle.
Flag Chat Message Reports a chat message to Habitica's moderators. It is a report, not a delete.
Mark Chat Seen Marks a group's chat as read, clearing the unread badge for the user.
Delete Chat Message Deletes a chat message. Only its author, a group manager, or the leader may do it.

Quests

Invite To Quest Starts a quest invitation in the party, spending one of the leader's quest scrolls.
Accept Quest Accepts a pending quest invitation for the authenticated user.
Reject Quest Declines a pending quest invitation. The quest can still start without them.
Force Start Quest Starts a quest without waiting for every invited member to answer, leaving out those who have not accepted.
Leave Quest Leaves a quest already under way, for the authenticated user. It continues for everyone else.
Cancel Quest Cancels a quest that has been invited but has not started, returning the scroll to its owner.
Abort Quest Aborts a quest already running. Every participant loses the progress made so far, and the scroll goes back to its owner.

Challenges

List Challenges Returns challenges the user can see: public ones, ones in their groups, and ones they have joined.
List Group Challenges Returns the challenges hosted in one group.
Get Challenge Returns one challenge with its group, prize, member count, and description.
Create Challenge Creates a challenge in a group. The prize is paid in gems out of the creator's balance and is committed at creation, so a non-zero prize spends real currency before anybody has done anything.
Update Challenge Changes a challenge's name, short name, summary, or description. The prize and the hosting group cannot be changed after creation.
Join Challenge Joins a challenge, which copies its tasks into the user's own list tagged with the challenge's short name.
Leave Challenge Leaves a challenge, with an option deciding whether its tasks stay in the user's own list.
Clone Challenge Copies a challenge with its tasks into a new one owned by the caller, which is how the same program runs again next month.
List Challenge Members Returns the members of a challenge.
Get Challenge Member Progress Returns one member's copies of the challenge tasks with their current values, which is how standings are read rather than guessed.
Select Challenge Winner Ends a challenge by naming its winner, awarding them the gem prize. It closes the challenge permanently, and the prize cannot be reassigned. This is the operation this page's human gate exists for.
Delete Challenge Deletes a challenge. Participants keep their copies of the tasks; the challenge and its leaderboard are gone.
List Challenge Tasks Returns the master tasks of a challenge, meaning the templates each participant gets a copy of.
Create Challenge Task Adds a task to a challenge, which pushes a copy to every participant. On a running challenge that changes everyone's task list, so it is not a quiet edit.
Unlink Challenge Task Detaches one of the user's copies of a challenge task, so it survives as an ordinary personal task after the challenge ends.
Unlink All Challenge Tasks Detaches every one of the user's copies at once, which is what a workflow calls after a challenge closes to keep the habits going.
Export Challenge CSV Returns a challenge's participant data as CSV, which is Habitica's own leaderboard export and the auditable form of the standings.

Group Tasks

List Group Tasks Returns the shared tasks of a group. Shared group tasks need a paid group plan, so a group without one has none.
Create Group Task Adds a shared task to a group, which members can then be assigned.
Assign Group Task Assigns a shared group task to a member, putting a copy of it in their own list.
Unassign Group Task Removes a member's assignment, taking their copy out of their list.
Request Task Rework Marks a member's completed group task as needing more work, returning it to their list and notifying them. Only a manager or the leader may do it.
Move Group Task Moves a shared group task to a new position in the group's list.

Members and Messages

Get Member Returns another member's public profile and stats by their user id.
Get Member Achievements Returns another member's earned achievements.
Check Interaction Allowed Asks Habitica whether a private message or a gem transfer to a given member would be refused, and why, without attempting it. The read that belongs before either.
Send Private Message Sends a private message to another Habitica member.
Transfer Gems Sends gems to another member from the caller's balance. It spends real currency and cannot be undone.
List Inbox Messages Returns the user's private message inbox, newest first.
Mark Messages Read Marks every private message as read, clearing the inbox badge.
Delete Message Deletes one private message from the user's inbox.
Delete All Messages Empties the user's private message inbox, with no undo.
List Members Looking For Party Returns members who have marked themselves as looking for a party, which is how a party leader finds people to invite.

Notifications

Mark Notification Read Marks one notification as read, removing it from the user's list.
Mark Notifications Read Marks several notifications as read in one call.
Mark Notifications Seen Marks several notifications as seen, which dims them without removing them.

Webhooks

List Webhooks Returns the webhooks registered on the account, including any this connector's trigger created.
Create Webhook Registers a webhook Habitica posts to when the chosen kind of thing happens, with the real filtering living in its options. For delivering to a system other than FlowRunner; a FlowRunner workflow uses the trigger instead.
Update Webhook Changes a webhook's URL, type, enabled state, or options. Its identifier cannot be changed.
Delete Webhook Removes a webhook from the account, stopping its deliveries.

Triggers

1 triggers

Event Triggers

On Habitica Event Fires when Habitica reports activity of the chosen kind, covering task activity, user activity, quest activity, and group chat. Group chat needs a group named on it, because Habitica subscribes chat webhooks to one group at a time, and choosing all events registers one webhook per event family. This is the entry point for workflows that react to progress rather than polling for it, which matters on a connector where the cheapest safe operation is a read.

Frequently Asked Questions

What can FlowRunner do with Habitica?

FlowRunner agents can run List Tasks, Get Task, and Create Task in Habitica, plus 115 more actions.

Does connecting Habitica to FlowRunner require OAuth?

No. Habitica connects to FlowRunner with an API key, no OAuth flow required.

Can Habitica trigger a FlowRunner workflow automatically?

Yes. Habitica supports 1 trigger that can start a FlowRunner workflow automatically.

Start building with Habitica

Free plan, no card required. Connect in minutes.

Start Building Free Talk to us