> ## 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.

# CRM

> Contact and company records built automatically from your team's email.

<Frame>
  <img src="https://mintcdn.com/macro-a2d84caa/KajalJo9igYN-lIy/images/crm_better.png?fit=max&auto=format&n=KajalJo9igYN-lIy&q=85&s=87b64e0cdee2b174b55fd5268093e9fc" alt="The CRM board view, with one column per stage" width="2550" height="1520" data-path="images/crm_better.png" />
</Frame>

<Note>
  Only a user's **primary** email is used to enrich the CRM. Secondary and tertiary emails are not part of the CRM.
</Note>

Macro's CRM builds itself on your team's emails so contact and company records are created and kept up to date automatically as you work. You don't have to run an importer or type in fields.

<Note>
  You can also work with our CRM through Macro's MCP server. To connect it, go to **Settings → MCP server**.
</Note>

### Tied into your email client

Macro CRM is deeply integrated with the Macro Mail client. It works with your existing email to enrich company properties with contacts and previous communications.

<Frame>
  <img src="https://mintcdn.com/macro-a2d84caa/KajalJo9igYN-lIy/images/crm_emails.png?fit=max&auto=format&n=KajalJo9igYN-lIy&q=85&s=1338e034338600ddfda7b233221f174f" alt="Macro CRM records alongside the Mail client" width="1434" height="928" data-path="images/crm_emails.png" />
</Frame>

With Macro there is instant bidirectional syncing, full access to properties, and access to the record itself by clicking in.

### Discussions

Every company and contact record has its own discussion thread. The CRM discussion should be used as a record of notes for that company so your team doesn't lose information in a separate chat. @mention a teammate and they'll receive a notification just like in a channel, and it all lands in the same inbox as the rest of your work. The discussion is ingested by [team-level memory](/product/unified-memory) and can be queried with the [Macro agent](/product/agents).

### @mentionable anywhere

@mention things everywhere — docs, tasks, etc. When a company is @mentioned in a Macro chat all its information is automatically shared to anyone in that channel, including past emails, discussion posts, and contacts.

<Frame>
  <img src="https://mintcdn.com/macro-a2d84caa/KajalJo9igYN-lIy/images/crm_chat.png?fit=max&auto=format&n=KajalJo9igYN-lIy&q=85&s=76880f428b1f96a8188bd4af5e40c755" alt="Team chat and @mentions on a CRM record" width="1558" height="554" data-path="images/crm_chat.png" />
</Frame>

### Board and list views

The board is the default view when you open **Customers**: every company appears as a card in the column for its current stage, and you drag a card to a new column to move it through your pipeline. Each column header is a stage:

<div style={{ display: 'flex', flexDirection: 'column', gap: '0.75rem', paddingLeft: '1.625rem', margin: '1rem 0' }}>
  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#9ca3af" size={10} /> <strong>Lead</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#4ade80" size={10} /> <strong>Qualified</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#a78bfa" size={10} /> <strong>Demo</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#fbbf24" size={10} /> <strong>Trial</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#fb923c" size={10} /> <strong>Negotiation</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#34d399" size={10} /> <strong>Customer</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="solid" color="#f87171" size={10} /> <strong>Churned</strong></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle" iconType="regular" color="#9ca3af" size={10} /> <span><strong>No stage</strong>, for companies that haven't been placed in your pipeline yet</span></div>
</div>

While records create themselves, stages are all manual: Macro doesn't yet know where a company lies in your pipeline and relies on you to distinguish your leads from your customers by setting each record's stage. New records start in **No stage** until someone on your team places them.

Prefer a table? Switch to the **List** view from the toggle in the topbar:

<Frame>
  <img src="https://mintcdn.com/macro-a2d84caa/YJRgYrJqf66DBzY8/images/crm_list_view.png?fit=max&auto=format&n=YJRgYrJqf66DBzY8&q=85&s=c53053ae607be489ae8bd9db34085353" alt="The CRM list view, a table grouped by stage" width="2412" height="1520" data-path="images/crm_list_view.png" />
</Frame>

The list trades cards for rows: every company is a row, and each column is a parameter you can set inline. The parameters you can edit are:

<div style={{ display: 'flex', flexDirection: 'column', gap: '0.75rem', paddingLeft: '1.625rem', margin: '1rem 0' }}>
  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle-dot" iconType="regular" color="#9ca3af" size={10} /> <span><strong>Stage</strong> — where the company sits in your pipeline (Lead through Churned, or No stage)</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle-dot" iconType="regular" color="#9ca3af" size={10} /> <span><strong>Owner</strong> — the teammate responsible for the account</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle-dot" iconType="regular" color="#9ca3af" size={10} /> <span><strong>Revenue</strong> — the value you attach to the account</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><Icon icon="circle-dot" iconType="regular" color="#9ca3af" size={10} /> <span><strong>Last Interaction</strong> — the most recent synced email</span></div>
</div>

Use the **Group** and **Filter** controls in the toolbar to reshape the table, or sort by column **Last Interaction** to surface the accounts you've talked to most recently.

<Note>
  Have CRM in Macro but can't see your leads? It needs to be enabled for your team — turn it on in your team settings, or contact your team admin to enable it.
</Note>

### Records build themselves

When someone on your team emails an external contact, Macro creates a contact record for them and groups contacts into companies by email domain (everyone `@acme.com` rolls up to one Acme record). Each contact tracks its first and last interaction, so you can see the full history of a relationship at a glance. Generic tool and vendor domains are filtered out.

### Team sharing

CRM is best used as a team feature, and it's where Macro's email auto-sharing lives. When **Email Sync** is on for a company, your team's email threads with that company become visible to teammates in the CRM, so nobody has to forward a thread just to share context. Turning it off for a company keeps the record but makes its threads private to their participants.

Team admins can also **hide** a company or contact entirely, which removes it (and its threads) from the team's view. Members see visible records; admins and owners can edit records, toggle Email Sync, and manage hidden ones.

<Note>
  Sharing of CRM records is determined by your team, not by mentions: @mentioning a company or contact in a channel does not share it, unlike documents. See [Mentions](/concepts/mentions#what-happens-when-you-mention).
</Note>
