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 from | The Mosaic equivalent |
|---|---|
| Superhuman | Email and Home (both are Gmail and Outlook clients) |
| Notion | Docs and databases, plus built-in tasks and CRM |
| Slack | Channels |
| Linear | Tasks |
| ClickUp | Tasks, with docs, CRM, and channels replacing the rest of the suite |
| Google Drive / Dropbox | Drive |
| Google Sheets / Excel | Spreadsheets |
| Zoom / Meet | Calls |
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.
| Superhuman | Mosaic | |
|---|---|---|
| Built on Gmail and Outlook (no migration) | ✓ | ✓ |
| j / k / e triage shortcuts | ✓ | ✓ |
| Multiple accounts in one unified inbox | X | ✓ |
| Signal vs. Noise split | X | ✓ |
| Messages, tasks, and @mentions in the same inbox | X | ✓ |
| Agents that draft, triage, and send | X | ✓ |
To switch:
- On Home, click Connect email when the feed is empty, or open Settings → Email and click Connect.
- Choose Gmail or Outlook / Microsoft 365 and finish signing in.
- 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.
| Notion | Mosaic | |
|---|---|---|
| Markdown-native docs | ✓ | ✓ |
| Databases | ✓ | ✓ |
| Spreadsheets | X | ✓ |
| Tasks | Sort of | Built in |
| CRM | No | Built in |
| Email and channels | X | ✓ |
| Agent access to your workspace | Rate-limited API | One unified search index |
To switch:
- Open Settings → Integrations.
- Under MCP integrations, click Connect on Notion and finish signing in.
- 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?"
| Slack | Mosaic | |
|---|---|---|
| Channels, threads, emoji | ✓ | ✓ |
| Inline thread replies (forum-style reading) | X | ✓ |
| One inbox shared with your email | X | ✓ |
| @mention a doc or task to share it automatically | X | ✓ |
| External channels with customers (Slack Connect) | ✓ | Keep Slack for external channels |
To switch:
An admin does this from team settings.
- Open Settings → Team → Connections.
- 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.
| Linear | Mosaic | |
|---|---|---|
| Status, priority, assignee | ✓ | ✓ |
| GitHub integration: branch, PR, and merge move the task | ✓ | ✓ |
| Tasks in the same app as your email, channels, and docs | X | ✓ |
| Turn an email or channel message into a task in one click | X | ✓ |
| Non-engineers see engineering work | Separate seat in a separate tool | Same workspace |
| Deep workflow configuration (cycles, triage, custom flows) | ✓ | Minimal by default, properties when you want them |
To switch:
- Open Settings → Integrations.
- Under MCP integrations, click Connect on Linear and finish signing in.
- 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.
| ClickUp | Mosaic | |
|---|---|---|
| Tasks, docs, chat | ✓ | ✓ |
| Setup required | Spaces, folders, lists, custom statuses | Works out of the box |
| CRM | Configure it yourself | Built in |
| X | ✓ | |
| One data model, one search index | X | ✓ |
| Agents with your whole workspace as context | X | ✓ |
To switch:
- Open Settings → Integrations.
- Under MCP integrations, click Add server.
- Set Name to ClickUp and URL to
https://mcp.clickup.com/mcp. - Sign in to ClickUp when Mosaic asks.
- 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.
| Mosaic | Superhuman | Notion | Slack | Linear | ClickUp | |
|---|---|---|---|---|---|---|
| ✓ | ✓ | X | X | X | X | |
| Channels | ✓ | X | X | ✓ | X | ✓ |
| Tasks | ✓ | X | Via databases | X | ✓ | ✓ |
| Docs | ✓ | X | ✓ | X | X | ✓ |
| Databases | ✓ | X | ✓ | X | X | X |
| Spreadsheets | ✓ | X | X | X | X | X |
| Canvas | ✓ | X | X | X | X | Whiteboards |
| CRM | ✓ | X | Via databases | X | X | Via setup |
| Drive | ✓ | X | Attachments | Attachments | X | Attachments |
| Calendar | ✓ | ✓ | Separate app | X | X | ✓ |
| Calls | ✓ | X | X | Huddles | X | X |
| Reviews | ✓ | X | X | X | X | X |
| Agents | ✓ | X | ✓ | X | ✓ | ✓ |
| Routines | ✓ | X | Automations | Workflows | X | Automations |
| Home feed | ✓ | X | X | X | X | X |
| Projects | ✓ | X | Via databases | X | ✓ | ✓ |
| Unified Tagging | ✓ | X | X | X | X | X |
| Unified Search | ✓ | X | X | X | X | X |
| Unified Memory | ✓ | X | X | X | X | X |