> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started

> Set up Macro and learn the core workflow in about 15 minutes.

Macro replaces the pile of tabs (email, chat, tasks, docs, calls) with one fast, keyboard-driven workspace. This guide takes you from a fresh account to a working setup.

<Card title="Prefer a guided tour?" icon="calendar" href="https://cal.com/team/macro/macro-demo-call">
  Book a live onboarding call and a member of our team will walk you through setup and answer questions.
</Card>

## 1. Connect your email

Macro is not an email server, it's just an email client. It syncs with your existing Gmail or Google Workspace account, so your mail stays in Gmail. We recommend connecting your account during signup so your inbox is ready from the first minute.

Have more than one address? Add additional Gmail or Google Workspace accounts in **Settings**, and they all flow into a [single unified inbox](/product/email#multi-account-inbox). When you compose, you choose which address to send from.

<Note>
  Outlook and custom IMAP/SMTP support are planned. See the [FAQ](/faq) for details.
</Note>

## 2. Learn five keys

Macro is built keyboard-first. These five get you most of the way:

| Key                         | What it does                                                                                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <kbd>c</kbd>                | Open the create launcher, then <kbd>d</kbd> for a doc, <kbd>t</kbd> for a task, <kbd>e</kbd> for an email, <kbd>m</kbd> for a message, <kbd>a</kbd> for an AI chat |
| <kbd>cmd</kbd>+<kbd>k</kbd> | Command menu to jump to anything by name                                                                                                                           |
| <kbd>/</kbd>                | [Unified search](/product/search) across email, docs, tasks, messages, calls, and files                                                                            |
| <kbd>j</kbd> / <kbd>k</kbd> | Move down / up in any list                                                                                                                                         |
| <kbd>e</kbd>                | Mark done: archive an email, clear an inbox item                                                                                                                   |

The full list lives in [Keyboard shortcuts](/keyboard-shortcuts).

## 3. Triage from one inbox

Press <kbd>g</kbd> + <kbd>i</kbd> to open the [unified inbox](/product/inbox). Emails, channel messages, task assignments, @mentions, and agent responses all land here, split into **Signal** (needs your attention) and **Noise** (everything else).

Work the list with <kbd>j</kbd> / <kbd>k</kbd>, preview with <kbd>space</kbd>, and clear items with <kbd>e</kbd>. The list shrinks as you go.

## 4. Open work side by side

Macro has its own window manager. Press <kbd>cmd</kbd>+<kbd>\\</kbd> to create a *split*, and <kbd>shift</kbd>+<kbd>enter</kbd> to open any list item or @mention in a new split, for example your inbox on the left and the doc someone sent you on the right. Move focus with <kbd>shift</kbd>+<kbd>h</kbd> / <kbd>shift</kbd>+<kbd>l</kbd>, maximize with <kbd>shift</kbd>+<kbd>escape</kbd>. More in [Blocks](/concepts/blocks#splits).

## 5. Create a team

Click **Team** in the bottom left to create one. Teams exist to help you collaborate better as a group:

* **Auto-sharing**: tasks are visible to the whole team, and calls are recorded, transcribed, and shared by default. No "can you share that with me?" requests.
* [**Team memory**](/product/unified-memory): agents remember what your whole team is doing across email, messages, tasks, docs, and calls, not just your own chats.

Then create a [channel](/product/channels) per team or project (<kbd>c</kbd> + <kbd>m</kbd>). Channels are also how [permissions](/permissions) work in Macro: anything you @mention in a channel is automatically shared with its members, and access follows people as they join or leave. You can add anyone by email, even if they don't have a Macro account yet.

## 6. Put the agent to work

Press <kbd>c</kbd> + <kbd>a</kbd> to start a chat with an [agent](/product/agents) that has access to your entire workspace. Ask "what's the latest on the launch?" and it answers from your team's recent emails, messages, tasks, docs, and call transcripts. In any channel, mention **@Macro** to pull an agent into the conversation.

You can also set up [automations](/product/agents#automations): scheduled agent runs, like a daily to-do summary, are delivered to your inbox.

## 7. Connect your tools

* **GitHub**: Link your account in **Settings** under **Account**. Tasks will move through "In Progress," "In Review," and "Done" as you branch, open PRs, and merge. See [GitHub integration](/integrations/github).
* **MCP connectors**: connect Notion, Slack, and other tools under **Settings → Connectors** so agents can reach them. Migrating off one of them? See [Switch to Macro](/switch-to-macro).
* **Your coding agents**: point Claude Code, Codex, or any MCP client at your Macro workspace. See [MCP setup](/AI/mcp/overview).

## Next steps

<CardGroup cols={2}>
  <Card title="Watch the demo" icon="play" href="https://www.youtube.com/watch?v=Fn5hdzXsQQ8">
    A full walkthrough of Macro's core features in one video.
  </Card>

  <Card title="Key concepts" icon="cubes" href="/concepts/blocks">
    Blocks, mentions, and properties: the primitives everything is built from.
  </Card>

  <Card title="Keyboard shortcuts" icon="keyboard" href="/keyboard-shortcuts">
    The complete reference for working at full speed.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq">
    Licensing, self-hosting, comparisons, and how Macro fits your stack.
  </Card>
</CardGroup>