beeminderBeeminder API for goal tracking and commitment devices. Use when checking Beeminder goals, adding datapoints, viewing due goals, managing commitments, or tracking habits. Triggers on "beeminder", "goals due", "add datapoint", "track habit", "goal status", "derail".
Install via ClawdBot CLI:
clawdbot install ruigomeseu/beeminderDirect REST API access to Beeminder. No CLI dependencies.
Set two env vars:
BEEMINDER_USERNAME - Beeminder usernameBEEMINDER_AUTH_TOKEN - personal auth token from https://www.beeminder.com/api/v1/auth_token.json (requires login)All examples use:
BASE="https://www.beeminder.com/api/v1/users/$BEEMINDER_USERNAME"
curl -s "$BASE/goals.json?auth_token=$BEEMINDER_AUTH_TOKEN" | jq '[.[] | {slug, safebuf, baremin, limsum}]'
curl -s "$BASE/goals/GOAL.json?auth_token=$BEEMINDER_AUTH_TOKEN"
Key fields:
slug - goal identifiersafebuf - days of safety buffer (0 = due today, negative = in the red)baremin - minimum needed today to stay on tracklimsum - human-readable summary (e.g. "+1 due in 2 days")losedate - unix timestamp of derail daterate - commitment raterunits - rate units (d/w/m/y)headsum - summary of current statusgoalval - end goal value (null if no end goal)gunits - goal units (e.g. "hours", "pages")curl -s "$BASE/goals.json?auth_token=$BEEMINDER_AUTH_TOKEN" \
| jq '[.[] | select(.safebuf <= 0)] | sort_by(.losedate) | .[] | {slug, baremin, limsum}'
curl -s "$BASE/goals.json?auth_token=$BEEMINDER_AUTH_TOKEN" \
| jq --arg cutoff "$(date -d '+2 days' +%s)" \
'[.[] | select(.losedate <= ($cutoff | tonumber))] | sort_by(.losedate) | .[] | {slug, baremin, limsum}'
curl -s -X POST "$BASE/goals/GOAL/datapoints.json" \
-d "auth_token=$BEEMINDER_AUTH_TOKEN" \
-d "value=N" \
-d "comment=TEXT"
Optional: -d "requestid=UNIQUE_ID" for idempotent retries (safe to repeat without duplicating).
curl -s "$BASE/goals/GOAL/datapoints.json?auth_token=$BEEMINDER_AUTH_TOKEN&count=5&sort=daystamp"
curl -s -X PUT "$BASE/goals/GOAL/datapoints/DATAPOINT_ID.json" \
-d "auth_token=$BEEMINDER_AUTH_TOKEN" \
-d "value=N" \
-d "comment=TEXT"
curl -s -X DELETE "$BASE/goals/GOAL/datapoints/DATAPOINT_ID.json?auth_token=$BEEMINDER_AUTH_TOKEN"
curl -s "$BASE/goals.json?auth_token=$BEEMINDER_AUTH_TOKEN" \
| jq '[.[] | select(.safebuf <= 1)] | sort_by(.safebuf) | .[] | {slug, baremin, limsum, safebuf}'
curl -s -X POST "$BASE/goals/GOAL/datapoints.json" \
-d "auth_token=$BEEMINDER_AUTH_TOKEN" \
-d "value=1" \
-d "comment=done" \
-d "requestid=GOAL-$(date +%Y%m%d)"
https://www.beeminder.com/api/v1/ (https, www required)jq to parse responsesYYYYMMDD formatGenerated Mar 1, 2026
Individuals use the skill to monitor daily habits like exercise, reading, or meditation by adding datapoints and checking goal status. It helps maintain consistency by viewing due goals and safety buffers, preventing derailment through automated reminders.
Small teams or freelancers track project milestones and deadlines by setting Beeminder goals for tasks like coding hours or client deliverables. The skill enables checking due goals within days and adding progress datapoints, fostering accountability and on-time completion.
Coaches or individuals monitor fitness goals such as weight loss or workout frequency by using the skill to add datapoints for daily metrics and view goal summaries. It supports tracking progress with idempotent retries to avoid duplicate entries, ensuring accurate habit adherence.
Students or educators set learning objectives like study hours or course completion, using the skill to check due goals and add datapoints for daily progress. It aids in managing commitments by viewing safety buffers and derail dates, promoting steady academic advancement.
Users track savings or debt reduction goals by adding datapoints for daily or weekly contributions and monitoring goal status. The skill helps visualize progress through summaries and due dates, encouraging financial discipline with automated checks.
Integrate the skill into a coaching app where users pay monthly for personalized goal tracking and habit formation. Revenue comes from subscriptions, leveraging the skill to automate progress updates and due alerts, enhancing user retention through consistent engagement.
Sell the skill as part of a B2B software suite for companies to track employee goals and project milestones. Revenue is generated through licensing fees, using the skill to provide API-driven insights into team productivity and deadline management.
Offer a free app with basic goal tracking using the skill, then upsell premium features like advanced analytics or team collaboration. Revenue streams from in-app purchases and ads, utilizing the skill for core functionality to attract and convert users.
💬 Integration Tip
Ensure environment variables BEEMINDER_USERNAME and BEEMINDER_AUTH_TOKEN are securely set, and use jq for parsing JSON responses to handle data efficiently in scripts.
Manage Trello boards, lists, and cards via the Trello REST API.
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
Master OpenClaw's timing systems. Use for scheduling reliable reminders, setting up periodic maintenance (janitor jobs), and understanding when to use Cron v...
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
Kanban-style task management dashboard for AI assistants. Manage tasks via CLI or dashboard UI. Use when user mentions tasks, kanban, task board, mission con...