Faster Auto Accept Quests and Auto Notify on Quest End

Google Apps Script
	Google Apps Script
Maintainer:	EugeneG
Habitica API:	API v 3
Website:	script.google.com
See Also
Extensions, Add-Ons, and Customizations, Webhook processing with Google Apps Script

Features

• Auto accepts quest invites within a few seconds of receiving the quest
• Notifies via private message when a quest has just finished (to have priority in setting up the next quest)
• Either of the features above can be disabled
• Rate limit checking (auto-retries after delay)
• Auto creation of hourly trigger for auto accepting quests as backup on the rare times Habitica's webhook fails to trigger the script

Recent Events

On August 11th 2025, the original script stopped working. It still got triggered by "quest invited" webhook, but when it tried to accept the invitation the API would return a 403 Forbidden response with info message "This client or third-party tool has been blocked. [..]".

Background

Each call to the API has to include the X-Client Header such that Habitica staff can identify the source of each request. This was used to monitor the load on Habitica servers and to identify, which scripts send a lot of request causing errors. On June 4th 2025 one of Habitica's staff informed EugeneG of those issues in the scripts GitHub repository.

A little later, on August 8th 2025, Habitica published Release 5.38.2 which includes "Feature: Block email addresses and x-clients using /admin/blockers route.". Since the issues with this script have not been addressed, admins finally used the new feature to block all requests with X-Client header of this script (i.e. 01daa187-ff5e-46aa-ac3f-d4c529a8c012-Faster Auto Accept Quests and Auto Notify on Quest End).

Outcome

In the end, this means that this script won't be working until the underlying issues (i.e. sending a lot erroneous requests) aren't fixed. Most temporary solutions worked by circumventing the block, but are definitely not the way to go, since all the errors are a substantial resource drain on Habitica's servers.

Alternatives

As alternative, this script has been ported onto the Habitica GAS Template. The functionality is basically the same, but the logic has been improved to reduce the number of erroneous requests drastically. Automate Habitica is another way to automatically accept quest invites and do a lot more.

First-Time Setup Instructions

• Follow the easy step-by-step setup guide with pictures

Code

• Original (potentially not working): https://raw.githubusercontent.com/elrgarcia/Habitica-Faster-Auto-Accept-Quests-and-Auto-Notify-on-Quest-End/master/Code.txt

Optional Customizations

• ENABLE_AUTO_ACCEPT_QUESTS can be set to 0 to disable auto accepting quests
• ENABLE_QUEST_COMPLETED_NOTIFICATION can be set to 0 to disable auto notify on quest end

Update Instructions

• If you already had an earlier version of the script set up previously and want to update to a newer version, do all three parts under Applying Updates to Streamlined Scripts

YouTube Step-by-Step Instructions

• https://youtu.be/Vutj4igrZwc (Updated Apr 29, 2023 for new Google Apps Script interface)
  • Google Script home: https://script.google.com
  • Your Habitica API details: https://habitica.com/user/settings/api

Credits and Acknowledgments

• @steelblade for initial webhook tips and debugging help