> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/mcp/connect-grok.md).

# Connect Grok

Connect Grok to your Shortcut workspace as a custom connector, by signing in to Shortcut or with an API token, and let it finish the estimates it drafts.

After this page, Grok can look up your customers, read your schedule, and answer questions about your jobs, invoices, and payments in your Shortcut workspace. With **AI agent** access it can also draft an estimate and send it, book jobs, and remind a customer about an invoice.

The Shortcut MCP server is at:

```
https://api.shortcutco.com/mcp
```

Workspaces on Shortcut's dev environment use `https://dev.shortcutco.com/api/mcp`; see [Environments](https://docs.shortcutco.com/developers/concepts/conventions.md#environments). In Shortcut, **Settings → API & integrations → Connect an AI app** has a Grok tile with these steps and this workspace's server URL.

## 1. Add Shortcut to Grok

1. Open `grok.com/connectors`.
2. Select **New Connector**, then **Custom**.
3. Paste `https://api.shortcutco.com/mcp`.

On Grok Business and Enterprise, a team admin adds the connector first, in the xAI console at `console.x.ai`: choose your team, open **Grok Business → Connectors**, select **+ Add Connector**, then **Other**, and paste the same URL. Members then find it in Grok's connectors.

## 2. Authenticate

Grok shows how it authenticates when you add the server. Both ways need a company admin of your Shortcut workspace.

**If Grok opens Shortcut to sign in:**

1. Sign in with your Shortcut email and password if asked.
2. Shortcut shows what Grok is asking for: your workspace, where it sends you back, and the scopes. Grok registers itself, so Shortcut labels its name as not verified.
3. Under **What should Grok be able to do?**, keep **Only what it asked for** for read access, or choose **Work for you as an AI agent**. Select **Approve**.

**If Grok asks for a header or API key instead:**

1. In Shortcut, open **Settings → API & integrations**, select the Grok tile, then **Create token**.
2. Choose **AI agent** to let Grok finish work, or **Read everything** to start read-only. Create the token and copy it.
3. In Grok, enter it as the header `Authorization` with the value `Bearer` followed by a space and the token.

## Read access or AI agent

|                                                                          | Read everything | AI agent |
| ------------------------------------------------------------------------ | --------------- | -------- |
| Look up customers, the schedule, jobs, estimates, invoices, and payments | Yes             | Yes      |
| Create and change customers, leads, estimates, jobs, and visits          |                 | Yes      |
| Send estimates and invoices, remind customers, start your automations    |                 | Yes      |
| Complete visits, record payments, void invoices                          |                 |          |

With read access, Grok can tell you everything about an estimate but cannot draft or send one. With **AI agent**, Grok drafts an estimate with `create_estimate` (for a lead or an existing customer) and sends it with `send_estimate`, which emails or texts your customer exactly as **Send** in the app does. Give **AI agent** access to a Grok you direct and watch. See [Presets](https://docs.shortcutco.com/developers/concepts/scopes.md#presets).

## 3. Try it

In a new conversation, ask:

* "What's on the schedule today, by crew?"
* "Find the customer at 412 Elm St and show me their open estimates."
* "Draft an estimate for Robin Alvarez for weekly mowing at our usual rate, then show it to me before you send it."
* "What can you do in Shortcut with this connection?"

The last one runs `explain_scopes`, which lists what Grok can do and how to give it more. See [MCP tools](https://docs.shortcutco.com/developers/mcp/tools.md) for every tool.

## Disconnect

* **Signed in:** in Shortcut, open **Settings → API & integrations → Connected apps** and select **Disconnect** next to Grok. Grok loses access on its next request.
* **Token:** revoke the token in **Settings → API & integrations**.

Remove the connector in Grok too.

## Troubleshooting

* **Grok says it can't send an estimate, or can only draft one.** Its access is read-only or a token without **Send estimates**. Disconnect it and connect again choosing **Work for you as an AI agent**, or replace its token with one from the **AI agent** preset.
* **Sign-in says "Ask a company admin".** Only company admins can approve a connection.
* **Grok can't reach the server.** Check the URL is exactly as above. Grok connects from the internet, so a server on your own computer would need a tunnel; Shortcut's server does not.
