Connect Habitica with Hookshot™ and your stack

Habitica is an open-source task management application that gamifies productivity by turning tasks into role-playing game elements.

Tools and triggers

What Agents can do in Habitica

Available tools and events after Habitica is connected.

  • Add Push Device

    Tool to register a push notification device for the authenticated user. Use when you need to enable push notifications for mobile devices or UnifiedPush clients.

  • Add Tag to Task

    Tool to add a tag to a task. Use when you need to categorize or label a task with an existing tag.

  • Add Task to Challenge

    Tool to add a new task to a specified challenge. Use when you need to programmatically create a challenge task after the challenge is set up and you have its ID.

  • Clone Challenge

    Tool to clone an existing challenge. Use when you need to duplicate a challenge to a different group with a new name.

  • Create Challenge

    Tool to create a new challenge. Use when you need to start a challenge in a specific group with title, summary, and optional tasks.

  • Create Habitica Party

    Create a new Habitica party for collaborative gameplay. Use this tool to create a party where users can: - Participate in quests together - Chat with party members - Share achievements and progress **Important Notes:**…

  • Create Tag

    Tool to create a new tag. Use after determining the desired tag name.

  • Create Task

    Create a new task in Habitica. Supports four task types: - 'habit': Recurring positive/negative actions (use up/down to enable +/- buttons) - 'daily': Scheduled tasks that repeat on a schedule (configure with…

  • Create Webhook

    Tool to create a new webhook for taskActivity events. Use when you need real-time notifications of task creation, updates, deletion, or scoring.

  • Delete Group Chat Message

    Tool to delete a chat message from a Habitica group (party, guild, or Tavern). Use when you need to remove a specific chat message. Note that only the message author or group moderators can delete messages.

  • Delete Habitica Challenge

    Permanently delete a Habitica challenge. Only the challenge leader (creator) or an admin can delete a challenge. This action is irreversible - once deleted, the challenge and all associated tasks are permanently…

  • Delete Habitica Tag

    Tool to delete a tag for the authenticated user. Use when you need to remove an obsolete tag after confirming it’s no longer applied to any tasks.

  • Delete Task

    Permanently deletes a user's task (habit, daily, todo, or reward) by its ID. The task cannot be recovered after deletion. Use get_tasks to list tasks and their IDs first.

  • Delete Task Checklist Item

    Tool to delete a checklist item from a task. Use when you need to remove a specific checklist item from a todo or daily task.

  • Delete User Message

    Tool to delete a message from the authenticated user's inbox by its ID. Use when you need to remove a specific message from the user's Habitica inbox.

  • Delete User Push Device

    Tool to remove a push device registration from the authenticated user's account. Use when you need to unregister a device that should no longer receive push notifications.

  • Dismiss Bailey Announcement

    Tool to dismiss the latest Bailey announcement in Habitica, allowing it to be read later. Use this when the user wants to clear the current news notification without reading it. The announcement will reappear later.

  • Equip Item

    Tool to equip or unequip gear, pets, mounts, or costume items in Habitica. Use when you need to change the user's equipped items. Equipping an already-equipped item will unequip it.

  • Export Challenge to CSV

    Tool to export a Habitica challenge to CSV format. Use when you need to download challenge data as a CSV file. The CSV contains all challenge tasks and participant information.

  • Export User Data JSON

    Exports the authenticated user's complete data in JSON format. Use when you need a full backup or comprehensive snapshot of all user data. Returns the raw internal data structure with all fields and nested objects.

  • Get Challenge

    Tool to retrieve details of a specific challenge. Use when you have the challenge ID and need its full data.

  • Get Challenge Tasks

    Tool to get all tasks for a specified challenge. Use when you have a challenge ID and need to list its defined tasks, including challenge metadata per task.

  • Get Content

    Retrieves all Habitica game content definitions in a single request. Returns ~9MB of static game data including achievements, quests, gear, pets, mounts, eggs, hatching potions, food, backgrounds, spells, and more. Use…

  • Get Content by Type

    Retrieves Habitica game content data filtered by a specific category type. Use this tool to fetch game definitions like quest details, equipment stats, pet/mount info, backgrounds, spells, or other static game content…

Setup

Connect Habitica in Hookshot™

Pick a scope, then confirm what can start a Protege and what it can do.

Trigger Access

What can start a Protege from this app.

Tool Access

What a Protege can do after it starts.

Connection scope

Prefer team for production.

Team

Shared credential for production and unattended runs.

Personal

Tied to one user—only when the workflow needs their account.

Chat

Team-scoped for supported chat surfaces.

Full setup guide

Build with us

See Hookshot™ in your stack.

Request early access or book a live walkthrough with the team.

Request Demo
Hookshot™ setup screen — AI agent workflow configuration with model selection, trigger status, and governance controls.