@mind-your-now/openclaw-plugin

OpenClaw plugin for Mind Your Now - AI-powered task and life management

Overview

This plugin integrates Mind Your Now (MYN) with OpenClaw agents, enabling AI assistants to manage tasks, calendar, habits, and more using the MYN productivity methodology.

Features

• 14 powerful tools for complete MYN integration
• Urgency-based prioritization following the MYN methodology
• Shared API client with automatic authentication
• Built-in skill companion for workflow guidance
• TypeScript-first with full type safety
• Comprehensive test coverage

Installation

# Install via OpenClaw
openclaw plugins install @mind-your-now/openclaw-plugin

# Or via npm
npm install @mind-your-now/openclaw-plugin

Configuration

Add to your OpenClaw configuration:

plugins:
  entries:
    myn:
      enabled: true
      config:
        apiKey: "your-myn-api-key"  # Required: API key with AGENT_FULL scope
        baseUrl: "https://api.mindyournow.com"  # Optional: defaults to production

Getting an API Key

1. Log into your Mind Your Now account
2. Go to Settings → API Keys
3. Generate a new key with AGENT_FULL scope

Tools Reference

myn_tasks

Manage tasks, habits, and chores.

action: list | get | create | update | complete | archive | search

Examples:

# List critical tasks
action: list
priority: CRITICAL
status: PENDING

# Create a task (UUID auto-generated if omitted)
action: create
title: "Finish quarterly report"
taskType: TASK
priority: CRITICAL
startDate: "2026-03-01"
duration: "2h"
isAutoScheduled: true
calendarName: "Work"
scheduleNames:
  - "Morning"

Scheduling Parameters:

• isAutoScheduled (boolean): Enable auto-scheduling by the planning system. Defaults to true.
• calendarId / calendarName: Link the task to a specific calendar. calendarName is resolved to an ID automatically.
• scheduleNames (string[]): Schedule names to assign (e.g., ["Morning"], ["Weekday Evening", "Weekend Morning"]). Resolved to IDs automatically.

myn_debrief

Generate and manage Daily Debrief sessions.

action: status | generate | get | apply_correction | complete_session

Examples:

# Generate morning debrief
action: generate
type: DAILY
context: "Morning planning session"
focusAreas:
  - work
  - health

# Generate evening review
action: generate
type: EVENING

The type parameter for generate accepts: DAILY, EVENING, WEEKLY, WEEKLY_AND_DAILY, ON_DEMAND. Defaults to DAILY.

myn_calendar

Manage calendar events and meetings.

action: list_calendars | list_events | get_event | create_event | update_event | delete_event | move_event | meetings

Examples:

# List available calendars
action: list_calendars

# Create an event
action: create_event
title: "Team Standup"
startTime: "2026-03-01T09:00:00Z"
endTime: "2026-03-01T09:30:00Z"

# Update an event
action: update_event
eventId: "event-uuid"
newTitle: "Team Standup (Rescheduled)"
newStartTime: "2026-03-01T10:00:00Z"

# Move event to family calendar
action: move_event
eventId: "event-uuid"
destinationCalendarName: "Family"

Calendar events may include a taskId field (MYN task UUID) when the event is linked to a task.

myn_habits

Track habits, streaks, and reminders.

action: streaks | skip | chains | schedule | reminders

myn_lists

Manage grocery and shopping lists.

action: get | add | toggle | bulk_add | update | delete | delete_checked | convert_to_tasks

myn_search

Unified search across tasks, events, notes, and memories.

action: search
query: "quarterly report"
types:
  - task
  - event

myn_timers

Manage countdowns, alarms, and pomodoro sessions.

action: create_countdown | create_alarm | list | cancel | snooze | pomodoro

Examples:

# Create a pomodoro session
action: pomodoro
workDuration: 25
breakDuration: 5
sessions: 4

# Create a countdown
action: create_countdown
durationMinutes: 30
label: "Focus time"

myn_memory

Store and retrieve agent memories.

action: remember | recall | forget | search

Examples:

# Remember user preference
action: remember
content: "User prefers morning meetings before 10am"
category: PREFERENCE

Categories: PREFERENCE, PATTERN, STYLE, MYN_BEHAVIOR, PERSONAL, RELATIONSHIP

myn_profile

Manage user profile, goals, and preferences.

action: get_info | get_goals | update_goals | preferences

myn_household

Manage household members, invites, and chores.

action: members | invite | chores | chore_schedule | chore_complete

myn_projects

Manage projects and categories.

action: list | get | create | move_task

myn_planning

AI-powered planning and scheduling.

action: plan | schedule_all | reschedule

myn_ynab

YNAB budget management with full read/write access.

# Budget & accounts
action: budget_overview | category_balance | list_categories | account_balances | set_budget_amount | set_category_goal | goal_progress | budget_months | search_payees

# Transactions
action: create_transaction | create_transactions_bulk | list_transactions | update_transaction | delete_transaction | split_transaction

# Scheduled transactions & subscriptions
action: scheduled_transactions | create_scheduled_transaction | update_scheduled_transaction | delete_scheduled_transaction | subscriptions | upcoming_bills

# Analytics
action: spending_insights | payee_analysis | spending_trends | net_worth | debt_tracking

# Category management
action: create_category_group | create_category | rename_category | move_category | rename_category_group

# Connection
action: connection_status

# Budget selection (after YNAB Fresh Start)
action: list_budgets | switch_budget

Examples:

# Check budget overview
action: budget_overview

# Create a transaction
action: create_transaction
accountId: "account-uuid"
payeeName: "Grocery Store"
amount: -45.50
categoryName: "Groceries"

# Get spending insights
action: spending_insights
months: 3

Amounts are in dollars (negative for expenses). Categories are resolved by name via fuzzy match. categoryName is required for all non-transfer transactions.

myn_a2a_pairing

Pair OpenClaw with MYN/Kaia via the A2A (Agent-to-Agent) protocol.

action: redeem_invite | ping | send_message | get_agent_card

Examples:

# Redeem an invite code from MYN Settings
action: redeem_invite
inviteCode: "ABC-12345"
agentName: "openclaw"

# Ping MYN after pairing
action: ping
agentKey: "key-from-redeem-invite"

# Send a message to Kaia
action: send_message
agentKey: "key-from-redeem-invite"
message: "Hello from OpenClaw"
intent: chat

The MYN Methodology

Mind Your Now uses urgency-based prioritization rather than traditional importance-based systems.

Critical Now (≤ 5 items)

The "Going Home Test": "Would you work until midnight to finish this?"

• If NO → It's not Critical Now
• If YES → It belongs here
• Maximum 5 items - More than 5 and things slip

Opportunity Now (≤ 20 items)

Tasks you'd like to do soon but aren't burning. The max you can scan in one glance.

Over-the-Horizon (10+ days out)

Items with start dates 10+ days in the future. This gets them OFF your mental radar so you can focus.

Parking Lot

Low urgency tasks that don't fit elsewhere.

Task Creation Rules

When creating tasks, you MUST provide:

| Field | Description | |-------|-------------| | taskType | TASK, HABIT, or CHORE | | priority | CRITICAL, OPPORTUNITY_NOW, OVER_THE_HORIZON, or PARKING_LOT | | startDate | ISO 8601 date (YYYY-MM-DD) |

Type-Specific Requirements:

• HABIT: Must have recurrenceRule
• CHORE: Must have recurrenceRule, always household-scoped

Duration Format: Use simple format like "30m", "1h", "1h30m" (NOT ISO PT prefix)

Skill Companion

This plugin includes a companion skill at skills/myn/SKILL.md that teaches agents MYN workflow patterns including:

• The morning routine (Daily Debrief)
• Task creation best practices
• Priority management
• Common workflows

Development

# Clone the repository
git clone https://github.com/mindyournow/openclaw-plugin.git
cd openclaw-plugin

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Type check
npm run typecheck

API Reference

MynApiClient

The shared API client used by all tools:

import { MynApiClient } from '@mind-your-now/openclaw-plugin';

const client = new MynApiClient(
  'https://api.mindyournow.com',
  'your-api-key'
);

// Make authenticated requests
const tasks = await client.get('/api/v2/unified-tasks');
const newTask = await client.post('/api/v2/unified-tasks', { ... });

Testing

The plugin includes comprehensive test coverage:

# Run all tests
npm test

# Run with coverage
npm run test -- --coverage

# Watch mode
npm run test:watch

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

MIT © Mind Your Now

Support

• Email: [email protected]
• Issues: https://github.com/mindyournow/openclaw-plugin/issues
• Documentation: https://docs.mindyournow.com