Skip to main content

API

Mind Your Now has a REST API for scripts, AI assistants and other tools that work with your account.

Authentication​

Use an API key, sent in the X-API-KEY header:

curl -H "X-API-KEY: YOUR_API_KEY" \
"https://api.mindyournow.com/api/v2/unified-tasks"

The Mind Your Now apps sign in with an emailed link and handle their own session tokens; you don't need those for the API. For AI assistants that support OAuth, see Connect an AI assistant (MCP).

Create an API key​

  1. In Mind Your Now on a computer, go to Settings → API Keys and click Create API Key.
  2. Enter a Name and, if you like, a Description and an Expiration Date.
  3. Under Permissions, choose what the key can do (see below).
  4. Click Create API Key and copy the key. It is shown only once.

Keys are stored hashed. To revoke one, use the Revoke key button next to it in Settings → API Keys.

Permissions​

Permission in the appScopeAllows
Full Agent Accessagent:full (AGENT_FULL)Every non-admin endpoint. Use this for AI assistants and plugins such as OpenClaw.
List Tasks, View Task Details, Create Tasks, Update Tasks, Delete Tasks, Calendar Operationstasks:*The matching task operations
List Schedules, View Schedule, Create Schedules, Update Schedules, Delete Schedulesschedules:*The matching schedule operations
List Projects, View Project, Create Projects, Update Projects, Delete Projectsprojects:*The matching project operations
Read User Profileuser:readYour basic profile

Main endpoint groups​

All of these accept a key with Full Agent Access. The reference has every operation, parameter and schema.

AreaPath
Tasks, habits and chores/api/v2/unified-tasks
Task sharing/api/v2/unified-tasks/{taskId}/share, /api/v2/unified-tasks/shared-with-me (see task sharing for developers)
Task comments/api/v2/unified-tasks/{taskId}/comments
Chores/api/v2/chores
Habits/api/habits/reminders, /api/habits/chains
Compass reports/api/v2/debrief
Calendar/api/v2/calendar
Meetings/api/v2/calendar/meetings/{eventId}/skip, /api/v2/calendar/meetings/{eventId}/decline
Timers/api/v2/timers
Search/api/v2/search
Schedules/api/schedules
Projects/api/project
Households/api/v1/households
Grocery lists/api/v1/households/{householdId}/grocery-list
Your account/api/v1/customers
Kaia's memories/api/v1/customers/memories
Kaia conversations/api/v1/ai/conversations

Meetings​

  • Skip marks a meeting as skipped for you only. Nothing changes on the calendar and nobody is notified. GET /api/v2/calendar/meetings/skipped lists skipped meetings, and DELETE /api/v2/calendar/meetings/skip/{meetingId} un-skips one.
  • Decline declines the invitation in your connected Google or Microsoft calendar, which tells the organizer. You must be an attendee, not the organizer.

Kaia endpoints​

Endpoints that use Kaia, such as writing a Compass report or sending her a message, work only after the account holder has allowed AI data sharing in Settings → Kaia AI. Until then they answer 403 with the code AI_CONSENT_REQUIRED.

Errors​

Errors use standard HTTP status codes with a JSON body that includes a message: 400 for a bad request, 401 for a missing or invalid key, 403 when the key or account isn't allowed to do this, and 404 when the item doesn't exist.

Questions: support@mindyournow.com.