How to use mirv

🚀 Getting started

mirv runs right in your browser at go.mirv.app — and installs as a real app on your phone and desktop. There's nothing to download to get going.

1. Go to go.mirv.app and create an account with your email and a password. It's free, and that includes the AI agent.
2. You land in My Workspace — your home for every list. A starter set of lists is already there so you're never staring at a blank screen.
3. Press + Add task (or just start typing) to capture your first to-do. Hit Enter and capture the next one.
4. Open any task to add a due date, priority, notes, subtasks or a label — or leave it bare. mirv never makes you fill in fields you don't need.

The lay of the land

⚡ Capturing tasks

The whole point of a task app is to get things out of your head fast. mirv keeps capture to a single line.

Add a task

• Click + Add task at the top or bottom of any list and type a title.
• Press Enter to save and immediately start the next one — capture a whole brain-dump without touching the mouse.
• On the Today, Upcoming and other filter views, the quick-add box already knows the context — adding a task on Today stamps it due today automatically.

Fill in the details — only if you want to

Open a task to reveal its side panel. Everything here is optional:

🗂️ Lists, folders & subtasks

Structure your work as deeply — or as flatly — as you like. Folders hold lists, lists hold tasks, and tasks hold subtasks, as many levels as the work needs.

Create & nest lists

• Use + New in the sidebar to add a list or a folder.
• Drag a list onto a folder to nest it; drag tasks between lists to move them.
• Select a few lists and group them into a folder in one move — mirv always makes a real folder, never a confusing “list inside a list.”

Subtasks are first-class

A subtask is the same kind of object as a top-level task: it can have its own due date, priority, description, labels and even its own subtasks. When you move a task, its whole subtree comes with it — nothing gets orphaned.

Archive instead of delete

Finished a project but want to keep it? Archive the list and its entire subtree disappears from the sidebar, boards, dashboard and search — until you un-archive it. Nothing is ever lost.

🏷️ Labels & workspaces

Lists are where things live; labels and workspaces are how you slice across them.

Labels

Add a label like #launch or #errands to any task — and to any note. There's one shared label namespace across your whole account, so a label on a meeting note and a label on the tasks it spawned surface together everywhere. Type to autocomplete existing labels, or create a new one on the fly.

Workspaces

Workspaces group whole sets of lists — a clean split between Work and Personal, say, or a shared space for a team. Switch the active workspace from the top of the sidebar to filter everything down to just that context. You can share a workspace or an individual list with someone by email.

🔄 List · Board · Calendar

The same tasks, shown three ways. Switching is one click and never changes your data — a board is just a view, not a separate thing you have to maintain.

How to switch views

Use the view switcher at the top of any list or your whole workspace:

📊 Dashboard & search

The dashboard is your daily cockpit; search is how you find anything in a second.

Dashboard

• Today & Overdue — what needs attention right now.
• Next actions — the GTD-style “do these next” queue across every list.
• Work by list and Stuck projects — where your effort is, and what's quietly stalled.
• A 14-day completion trend so you can see your momentum.

Search

Start typing in the search box and mirv suggests filters, labels, lists, tasks and notes as you go — click a suggestion to jump straight there. Search looks inside task titles and long descriptions, so you can find that detail you buried in a note three weeks ago.

🧭 Focus, recurring & more

The features that turn a task list into a system you actually trust.

Plan your day & shut it down

In the Calendar view, Plan my day auto-schedules your open work into your free time and shows yesterday's hand-off note. At the end of the day, Shutdown / review walks through what got done, what slipped, and leaves a hand-off note for tomorrow.

✨ The Mirv AI agent

mirv ships with a free, built-in AI assistant — no API key, no add-on, no extra subscription. It doesn't just chat: it edits your real workspace.

How to use it

1. Click the Mirv bubble in the corner of the app to open the chat.
2. Ask in plain language — “what's overdue and what should I do first?”, “move everything I missed this week to tomorrow,” or “start a timer on Prepare investor deck.”
3. For anything bulk or destructive, Mirv proposes the change and waits for your OK before touching a thing — then shows you exactly what it did.

Things to ask it

• “Plan my week around the launch on Thursday.”
• “Reschedule everything I missed and reprioritize my Work list.”
• “Turn these meeting notes into tasks and link them.”
• “What's blocking the launch?” — it maps your dependencies.
• “Summarize my dashboard and tell me where I'm stuck.”

📝 Notes

Obsidian-style Markdown notes that live in the same place as your tasks — and link straight to them.

Writing notes

• Open Notes in the sidebar and hit New → Note (or a folder to organize them).
• Write in Markdown, or just type and flip the one-click Write / Preview toggle to see it rendered.
• Type [[ to link to any task or other note, with live autocomplete — Obsidian-style [[wikilinks]].
• Paste or drop images straight in. Add labels that are shared with your tasks.

Organize & archive

Notes live in folders you can rename, move, archive or delete. Archived notes tuck into an Archived section rather than disappearing. Every note exports to .md, and the whole set to a .zip — your writing is never locked in.

🔌 Integrations

This is where mirv really opens up. Connect your AI assistant, sync your calendar, bring your data in from another app — and take it all back out whenever you like.

🧩 Connect Claude, Cursor & any AI (MCP)

mirv speaks the Model Context Protocol (MCP) — the open standard that lets AI assistants use real tools. Connect Claude Desktop, Cursor, or any MCP-capable client and it can see and act on your actual tasks and notes, not a copy you pasted in.

{
  "mcpServers": {
    "mirv": {
      "command": "npx",
      "args": ["tsx", "…/apps/mcp/src/server.ts"],
      "env": {
        "TASKLIST_TOKEN": "mirv_••••••••••••",
        "TASKLIST_API_URL": "https://go.mirv.app"
      }
    }
  }
}

Set it up in three steps

1. In mirv, open Settings → Connect to Claude. mirv generates the config above and a scoped access token — choose read-only or read & write — with a one-click copy button.
2. Paste it into your MCP client's config (Claude Desktop, Cursor, …) and restart the client. That's the entire setup.
3. Ask away — your assistant now has the full toolset into your live workspace. Revoke the token any time from Settings → API tokens.

What your assistant can do

The same actions the built-in agent has — search tasks, build boards, manage dependencies, run timers, plan your day, and read & write notes. A few examples:

Common questions

📅 Calendar sync

Connect your real calendar so your scheduled tasks and your meetings live in one grid. Sync is two-way: tasks you schedule in mirv appear on your calendar, and your existing events show up in mirv.

Connect a calendar

1. Open the Calendar view, then its settings (the gear / “Calendars” panel).
2. Choose a provider and authorize:
   • Google Calendar — sign in with Google and grant calendar access.
   • Microsoft Outlook — sign in with your Microsoft account.
   • Apple iCloud — connect over CalDAV with an app-specific password.
3. Pick which calendars are visible, set per-calendar colours, and choose one default calendar to write new events to.

What you can do once it's connected

• Drag a task onto a time slot to schedule it — it syncs out to your real calendar.
• Turn an event into a task — click any incoming event on the grid and convert it (or keep it as-is).
• See a per-day workload gauge in the Day/Week headers — amber when you're near capacity, red when you're over-committed.
• Set recurring blocks (focus time, admin, meetings) and let auto-schedule pack matching tasks into them.
• Reschedules from your phone, another device, or your AI update every open grid live.

📥 Import from another app

Switching shouldn't mean retyping everything. mirv has built-in importers for the most common task apps, and they bring your structure across — not just a flat list.

How to import

1. Export your data from your old app (each one has its own “export” option).
2. In mirv, open Settings → Import and choose the app you're coming from.
3. Upload the export file. Optionally tick Replace my workspace for a clean slate.
4. Done — your folders, lists, tasks, due dates, priorities, notes and checklist items are now first-class tasks and subtasks.

🗒️ Transfer your notes

Bringing notes over from another tool? mirv imports them as clean Markdown and keeps your structure.

1. Open Settings → Transfer notes.
2. Choose your source — Obsidian, Apple Notes, or OneNote — and upload the export.
3. mirv converts the content to Markdown, turns folders into note folders, and maps Obsidian front-matter and #tags into shared labels.

From there your imported notes behave like any other mirv note: [[wikilinks]], Write/Preview, pasted images, labels shared with tasks, and full export back out.

📦 Export & own your data

Local-first means there's no lock-in. Your data is yours, and getting all of it out is one click — any time, for any reason.

📱 Apps & devices

One workspace, everywhere you are. Use mirv in the browser, install it as an app, or grab the native mobile apps.

🔐 Account, data & privacy

A few practical things about your account and how your data is handled.

Your account

• Set your name and avatar, change your password, and manage notification preferences in Settings.
• Choose per-event email and push notifications — task assigned, reminders, and more.
• Personalize the app: light/dark theme, density, which features show, and keyboard shortcuts — all saved to your account and synced across devices.

Privacy & security

• Connections use HTTPS; passwords are stored only as salted hashes.
• We never sell your data or use your content for advertising.
• You can export everything or delete your account at any time. See the Privacy Policy.

❓ Common questions

Quick answers to the things people ask most. Anything else, just email us.