How MarvinFlowy Works

• Todo items - Items marked as todos in Workflowy (checkbox mode) sync to your selected Marvin category
• Task content - Text changes sync both ways based on which was edited most recently
• Notes & descriptions - Workflowy notes sync to Marvin notes and vice versa
• Dates - Workflowy dates sync to Marvin scheduled dates and vice versa (inline dates, calendar dates, and times)
• Completion status - Completing a task in either app marks it complete in the other
• Tags & labels - Workflowy #hashtags sync with Marvin labels. New labels are created automatically if they don't exist in Marvin
• Project hierarchy - Parent nodes in Workflowy become projects in Marvin, preserving your task organization and nesting
• Project renames - Renaming a parent node in Workflowy updates the linked Marvin project title, and vice versa
• Link format conversion - HTML links in Workflowy automatically convert to Markdown links in Marvin, and back again

Tasks are matched between platforms using special emoji links in item titles:

• ⚡ link in Marvin titles - Every synced Marvin task and project gets a clickable ⚡ emoji at the start of its title that links back to the source Workflowy node
• 🔗 link in Workflowy titles (optional) - If enabled, Workflowy items get a clickable 🔗 emoji at the start of their title that links to the Marvin task

These links contain unique IDs that allow the sync to match items correctly. Notes are kept free for your own content.

Conflict Resolution

When both sides have changes, the sync uses a "last write wins" approach:

• If the Workflowy item was modified after your last sync, Workflowy's version is used
• Otherwise, Marvin's version is used

• Due dates - Marvin due dates are not synced. Only scheduled dates are synced (Workflowy dates become Marvin scheduled dates)
• Mirror nodes - Workflowy mirror nodes are not supported. Only the original node syncs.
• Time estimates - Marvin time estimates are not synced
• Recurring tasks - Recurring task instances use a "log completions only" approach (see below)
• Attachments - File attachments don't sync
• Rich formatting in titles - Bold, italic, underline, and strikethrough formatting is stripped from task titles for Marvin (Marvin doesn't render them in titles)

Marvin recurring task instances are excluded from normal bidirectional sync to prevent duplication and conflict issues. Instead, they use a "log completions only" approach:

• When you complete a recurring instance in Marvin, a completed node is created in Workflowy with a #recurring tag
• These completions appear in your daily Workflowy email digest alongside your other completed items
• Recurring instances that are not yet completed are not visible in Workflowy

A sync pair connects a Workflowy branch to a Marvin category. You can create multiple sync pairs to organize different areas of your life.

Example Setup

• Work - Workflowy "Work Projects" branch syncs to Marvin "Work" category
• Personal - Workflowy "Personal" branch syncs to Marvin "Personal" category
• Shopping - Workflowy "Shopping List" branch syncs to Marvin "Shopping" category

Settings Per Sync Pair

• Name - Optional friendly name for the sync pair
• Workflowy Branch - Which Workflowy node's children to sync (Home, Inbox, or any node up to 3 levels deep)
• Marvin Category - Which Marvin category to sync to
• Sync Enabled - Toggle to pause/resume syncing for this pair
• Add Marvin Links - Whether to add 🔗 links to Workflowy titles for quick access to Marvin

Dedicated habit sync pairs automatically log your completed Amazing Marvin habits to Workflowy each day. Completed habits appear as checked-off items under daily date nodes, with tags for habit type and completion counts. Past date nodes are automatically completed to keep your log tidy.

Get a private URL that returns today's scheduled tasks, habits, and calendar events as structured JSON — perfect for AI agents, custom dashboards, and automations.

• Tasks — Today's scheduled Marvin tasks with title, project, labels, time estimates, and completion status
• Habits — Today's habits with completion status, count, target, and scheduled times
• Calendar events — Upcoming, past, and all-day events from your connected calendars

Feed the URL to an AI agent for daily briefings, connect it to Zapier or Make for automations, or build your own dashboard. Data refreshes every sync cycle. Enable it in Settings after signing up.

Workflowy API Key

Get your Workflowy API key from workflowy.com/api-key

Amazing Marvin API Key

Get your Amazing Marvin API key from Amazing Marvin API Settings

• Use dedicated branches - Create specific Workflowy nodes for items you want to sync rather than syncing your entire Home
• Wait for sync - After making changes, wait for the next sync cycle before expecting to see updates in the other app
• Don't delete emoji links - The ⚡ and 🔗 links at the start of titles are how items are matched; deleting them will cause duplicates