tomevault-io 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 formatdone(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.
Source: daya0576/beaverhabits — distributed by TomeVault.