Beaver Habit Tracker

Track and manage your habits using the Beaver Habit Tracker API.

Audits

Pass

Security findings on these releases were reviewed by staff and cleared for public use.

ClawScanCleared

Agentic behavior and permission review.

Static analysisCleared

Pattern checks against bundled files.

VirusTotalCleared

Multi-engine malware detections and file reputation.

Install

openclaw skills install beaverhabits

Beaver Habit Tracker

Track and manage your daily habits using the Beaver Habit Tracker API.

API documentation: https://beaverhabits.com/docs

Setup

Environment Variables

Variable	Required	Default	Description
`BEAVERHABITS_API_KEY`	Yes	—	Your permanent API token from the Beaver Habits settings page
`SERVER_URL`	No	`https://beaverhabits.com`	Your Beaver Habits server URL (for self-hosted instances)

Getting Your API Key

Log in to your Beaver Habits instance
Open the menu → Tools → API Tokens
Click "Generate API Token"
Copy the token and set it as BEAVERHABITS_API_KEY

Tools

list_habits (overview)

List all habits and show a weekly ASCII overview. This is the default response for any habit-related query.

Step 1 — Get all habits:

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits"

Step 2 — For each habit, get completions over the last 5 days:

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions?date_fmt=%25d-%25m-%25Y&date_start={start}&date_end={end}&limit=100&sort=asc"

Response format: ["16-02-2026", "18-02-2026"] (array of completed date strings)

Step 3 — Render as ASCII table:

Example output:

              Mon   Tue   Wed   Thu   Fri   
Exercise       ✗     ✗     ✗     ✗     ✗     
English        ✓     ✗     ✗     ✗     ✗     
paipai         ✗     ✗     ✗     ✗     ✓     
Reading        ✗     ✗     ✗     ✗     ✗     
Table Tennis   ✗     ✗     ✗     ✗     ✗

Use ✓ for done, ✗ for not done. Default to 5 days ending today. Emoji are stripped from habit names for proper alignment.

complete_habit

Mark a habit as done (or undone) for a specific date.

Parameters:

habit_id (resolved): Automatically resolved by calling list_habits and matching the user's habit name. Never ask the user for this value.
date (required): Date in DD-MM-YYYY format
done (optional): true to complete, false to uncomplete (default: true)

curl -s -X POST \
  -H "Authorization: Bearer $BEAVERHABITS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date": "20-02-2026", "done": true, "date_fmt": "%d-%m-%Y"}' \
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions"

Response: {"day": "20-02-2026", "done": true}

Usage Instructions

When the user asks to list, show, or check habits, always respond with the ASCII overview table (not a plain list).
After completing or uncompleting a habit, always re-render the overview table to show the updated state.
Resolve habit names → IDs via list_habits. Never ask the user for a habit_id.
Default to today's date for completions unless specified. Use date_fmt=%d-%m-%Y.