Get Started

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.

​

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. When you compose, you choose which address to send from.

​

2. Learn five keys

Macro is built keyboard-first. These five get you most of the way: The full list lives in Keyboard shortcuts.

​

3. Triage from Home

Press g + h to open Home. Emails, channel messages, task assignments, @mentions, and agent responses all land here. Items that need your attention are in Signal. Everything else is in Noise. Work the list with j / k; the selected item previews next to the list. Clear items with e. The list shrinks as you go.

​

4. Open work side by side

Macro has its own window manager. Press \ to create a split, and shift+enter to open any list item or @mention in a new split, for example Home on the left and the doc someone sent you on the right. Move focus with shift+h / shift+l, maximize with shift+escape. More in Blocks.

​

5. Create a team

Open Settings → Team to create one. Teams exist to help you collaborate better as a group:

• Auto-sharing: tasks are visible to the whole team, and channel calls are recorded, transcribed, and shared by default. No “can you share that with me?” requests.
• Team 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 per team or project (c + g). Channels are also how 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 c + a to start a conversation with an agent 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 routines: agent runs on a schedule, like a daily to-do summary, or whenever something happens in Macro, like a new email arriving.

​

7. Connect your tools

• GitHub: Link your account in Settings → Integrations. Tasks will move through “In Progress,” “In Review,” and “Completed” as you branch, open PRs, and merge. See GitHub integration.
• Agent connections: connect Notion, Slack, Linear, and other tools under Settings → Agent connections so agents can reach them. Migrating off one of them? See Switch to Macro.
• Your coding agents: point Claude Code, Codex, or any MCP client at your Macro workspace. See MCP setup.

​

Next steps