Skip to Content
MosaicMosaicDocs

Switch to Mosaic

Migration guides for moving to Mosaic from Superhuman, Notion, Slack, Linear, and ClickUp.

Starter documentation. Features and account details may differ from this deployment.

Mosaic replaces several tools with one unified system, but you don't have to move over all at once. Most teams like to connect their old tools first to ensure nothing gets lost. Then, when you're ready, you can ask the agent to fully migrate you.

If you want to keep most of your existing tools and just use Mosaic for Email+Tasks or Docs+Files, for example, you're able to keep your other tools connected via MCP.

At a glance, here's what maps to what:

Coming fromThe Mosaic equivalent
SuperhumanEmail and Home (both are Gmail and Outlook clients)
NotionDocs and databases, plus built-in tasks and CRM
SlackChannels
LinearTasks
ClickUpTasks, with docs, CRM, and channels replacing the rest of the suite
Google Drive / DropboxDrive
Google Sheets / ExcelSpreadsheets
Zoom / MeetCalls

From Superhuman

The main difference between us and Superhuman is that Mosaic supports multiple accounts in one inbox. It also adds more intelligent Signal vs. Noise splits, and it fully unifies messaging, tasks, @mentions and more into a single inbox. Another benefit of Mosaic is that Agents can draft, triage, and send mail for you right from AI chat with an embedded email widget.

Both Mosaic and Superhuman are clients on top of Gmail and Outlook, so there's no migration in either direction. Your mail stays in Gmail or Outlook / Microsoft 365.

The j / k / e triage shortcuts you already know work unchanged.

SuperhumanMosaic
Built on Gmail and Outlook (no migration)✓✓
j / k / e triage shortcuts✓✓
Multiple accounts in one unified inboxX✓
Signal vs. Noise splitX✓
Messages, tasks, and @mentions in the same inboxX✓
Agents that draft, triage, and sendX✓

To switch:

  1. On Home, click Connect email when the feed is empty, or open Settings → Email and click Connect.
  2. Choose Gmail or Outlook / Microsoft 365 and finish signing in.
  3. Your mail and history are already there because Mosaic syncs with that account directly.

That's it. You can run both during the transition, or keep Superhuman around if you want.

From Notion

In Mosaic, tasks, CRM, email, channels, and files (docs, databases, spreadsheets, canvases, and other files in Drive) are each their own best-in-class, purpose-built Block, and they all share one data model and one search index. Each Block works like a real product, and agents can read all of it as one context vs. paging through a rate-limited API.

NotionMosaic
Markdown-native docs✓✓
Databases✓✓
SpreadsheetsX✓
TasksSort ofBuilt in
CRMNoBuilt in
Email and channelsX✓
Agent access to your workspaceRate-limited APIOne unified search index

To switch:

  1. Open Settings → Integrations.
  2. Under MCP integrations, click Connect on Notion and finish signing in.
  3. Open Agents, click New conversation, and ask it to import. For example:
Import my Notion workspace. Show me the plan before you create anything.

Pages become docs, kept in the same folder tree. Databases become databases. Databases that we detect track work become tasks.

We have a dedicated Notion importer. It reads the connected workspace and shows a plan of the pages, databases, and task lists it found. You choose what to include and whether the team can see it. Nothing is created until you approve the plan, and anything already imported stays.

From Slack

The main thing Mosaic improves on versus Slack is making channels/DM's less noisy and more focused for technical discussions. The first few replies in a thread show inline, so you don't have to open a thread every time someone replies, and a busy channel looks more like Reddit: organized, and easy to remember where a conversation happened.

Channel messages and @mentions appear on Home with your email.

The other big thing is channel-based sharing: @mention a doc or task in a channel and every member gets access to it automatically. This avoids the Slack+Notion footgun where people need to ask "hey can you share __ with me?"

SlackMosaic
Channels, threads, emoji✓✓
Inline thread replies (forum-style reading)X✓
One inbox shared with your emailX✓
@mention a doc or task to share it automaticallyX✓
External channels with customers (Slack Connect)✓Keep Slack for external channels

To switch:

An admin does this from team settings.

  1. Open Settings → Team → Connections.
  2. Click Import from Slack.

Import with history uses a Slack export from a workspace admin. Pick the channels, leave Include message history on to bring messages and threads, confirm the export belongs to the team's Slack workspace, and click Import selected channels. Files are not imported.

Import channels without history copies public channels and the teammates who are on your team. Messages stay in Slack.

From Linear

The difference between Mosaic and Linear is that on Mosaic, tasks live in the same app as your email, channels, and docs. You can turn an email or a channel message into a task in one click, and non-engineers can see engineering work without a seat in a separate tool. Tasks are also less ceremonious: fields are minimal by default, and story points, effort, etc. are there via properties if you really want them, but we advise keeping it light.

LinearMosaic
Status, priority, assignee✓✓
GitHub integration: branch, PR, and merge move the task✓✓
Tasks in the same app as your email, channels, and docsX✓
Turn an email or channel message into a task in one clickX✓
Non-engineers see engineering workSeparate seat in a separate toolSame workspace
Deep workflow configuration (cycles, triage, custom flows)✓Minimal by default, properties when you want them

To switch:

  1. Open Settings → Integrations.
  2. Under MCP integrations, click Connect on Linear and finish signing in.
  3. Open Agents, click New conversation, and ask it to import. For example:
Import my Linear workspace. Show me the plan before you create anything.

Issues become tasks. Linear teams, projects, and initiatives become projects.

From ClickUp

ClickUp covers tasks, docs, chat, goals, and whiteboards through a deep stack of spaces, folders, lists, and custom statuses that you configure yourself. Mosaic covers the same ground with dedicated tasks, docs, channels, and CRM that share one data model.

There's less setup and fewer knobs because each tool is already built for its job. Tasks keep the essentials (status, priority, assignee, and properties when you want them), and agents can read across all of it as one context.

The biggest day-to-day change is that tasks live in the same app as your email, channels, and docs. You can turn a message or an email into a task in one click, and @mentioning a task in a channel shares it automatically.

ClickUpMosaic
Tasks, docs, chat✓✓
Setup requiredSpaces, folders, lists, custom statusesWorks out of the box
CRMConfigure it yourselfBuilt in
EmailX✓
One data model, one search indexX✓
Agents with your whole workspace as contextX✓

To switch:

  1. Open Settings → Integrations.
  2. Under MCP integrations, click Add server.
  3. Set Name to ClickUp and URL to https://mcp.clickup.com/mcp.
  4. Sign in to ClickUp when Mosaic asks.
  5. Open Agents, click New conversation, and tell it what to copy. For example:
Import my open ClickUp tasks and the Docs in the Engineering space.
Skip archived work. Show me the list before you create anything.

The agent reads ClickUp and lists what it will create. It creates tasks and docs only after you say to.

Everything else

Settings → Integrations → MCP integrations is where these connections live. Notion and Linear have a Connect button. For any other tool, click Add server, enter its name and MCP URL, and sign in.

Then start a chat and name what to copy and what to skip. Ask the agent to show the list before it creates anything. The connected tool is only read.

Mosaic's MCP server has no rate limit. That includes the Free plan.

Files mostly migrate themselves: email attachments are extracted into Drive automatically, and anything you drag into a channel or doc is imported and searchable.

Mosaic vs. the world

Here's the full picture side by side of how Mosaic compares to the rest of the toolset.

MosaicSuperhumanNotionSlackLinearClickUp
Email✓✓XXXX
Channels✓XX✓X✓
Tasks✓XVia databasesX✓✓
Docs✓X✓XX✓
Databases✓X✓XXX
Spreadsheets✓XXXXX
Canvas✓XXXXWhiteboards
CRM✓XVia databasesXXVia setup
Drive✓XAttachmentsAttachmentsXAttachments
Calendar✓✓Separate appXX✓
Calls✓XXHuddlesXX
Reviews✓XXXXX
Agents✓X✓X✓✓
Routines✓XAutomationsWorkflowsXAutomations
Home feed✓XXXXX
Projects✓XVia databasesX✓✓
Unified Tagging✓XXXXX
Unified Search✓XXXXX
Unified Memory✓XXXXX

On this page