daya0576/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

1. Log in to your Beaver Habits instance
2. Open the menu → Tools → API Tokens
3. Click "Generate API Token"
4. 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.