API
Mind Your Now has a REST API for scripts, AI assistants and other tools that work with your account.
- Base URL:
https://api.mindyournow.com - Reference: api.mindyournow.com/docs lists every endpoint, parameter and schema.
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
- In Mind Your Now on a computer, go to Settings → API Keys and click Create API Key.
- Enter a Name and, if you like, a Description and an Expiration Date.
- Under Permissions, choose what the key can do (see below).
- 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 app | Scope | Allows |
|---|---|---|
| Full Agent Access | agent: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 Operations | tasks:* | The matching task operations |
| List Schedules, View Schedule, Create Schedules, Update Schedules, Delete Schedules | schedules:* | The matching schedule operations |
| List Projects, View Project, Create Projects, Update Projects, Delete Projects | projects:* | The matching project operations |
| Read User Profile | user:read | Your basic profile |
Main endpoint groups
All of these accept a key with Full Agent Access. The reference has every operation, parameter and schema.
| Area | Path |
|---|---|
| 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/skippedlists skipped meetings, andDELETE /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.