Skip to content

How to set up Grok for Horizline

Add Horizline to Grok as a custom connector, so Grok can look things up and make changes in your Horizline account from a chat.

Updated

Grok connects to Horizline the same way any AI assistant does: you give it Horizline’s address, sign in to Horizline, and choose what it may do. It then works as you, and deleting a record or changing money waits for your approval. Connecting an AI assistant explains all of that in full; this guide is the Grok side, step by step.

The screens below are Grok’s own, captured in November 2026. Grok changes its layout from time to time; if something has moved, look for the same names.

Before you start

  • In Horizline, open Settings → Integrations. If there is no AI assistants section, it is not switched on for your account yet; write to support to ask for it. Only the account owner can connect an assistant, until the owner turns on Let team members connect their own assistants in that section.
  • In Grok, you need an account that can add connectors. If the menu in step 1 has no Add connector, your Grok plan does not offer it.

1. Open Add connector

In Grok, choose + in the message box, then Add connector.

Grok's + menu: Upload a file, Projects, Skills, Add connector and Files.
Grok’s + menu.

2. Choose Custom

Grok opens New Connector. Choose Custom, Add your own custom connector, at the top of the list.

Grok's New Connector dialog, with a search field and Custom: Add your own custom connector.
Custom is at the top of the list.

3. Name it and give the address

In Custom Connector, fill in its two fields:

  • Name: Horizline
  • Server URL: Horizline’s server address. It is also in Horizline under Settings → Integrations → AI assistants.
    https://mcp.horizline.app/mcp

Then choose Add Connector.

Grok's Custom Connector dialog with the name Horizline and the server URL https://mcp.horizline.app/mcp, and Cancel and Add Connector buttons.
Custom Connector, filled in for Horizline.

4. Approve the connection in Horizline

Grok opens a Horizline page. Sign in if asked. You never give Grok your Horizline password.

  1. Check who is asking. The page names the application, which should be Grok. If you did not just add Horizline in Grok, choose Cancel.
  2. Under What it may do, untick anything you do not want Grok to do. See your contacts, jobs, tasks, materials, invoices, payments and reports is always included. Add and change contacts, jobs, tasks and materials and Prepare invoices and change what jobs are worth are yours to leave off.
  3. Choose Connect at the bottom of the page. It says Horizline is connected and takes you back to Grok.
The bottom of Horizline's page: what connecting means, a reminder to connect only if you just asked Grok to connect to Horizline, and Connect and Cancel buttons.
Horizline’s page, asking about Grok.

5. Ask Grok

Start a new chat and ask for something in your Horizline account. Naming Horizline helps Grok choose it. For example:

  • “Which of my jobs in Horizline are still open?”
  • “Add a note to the Harper contact in Horizline: they want the quote by Friday.”
  • “In Horizline, add a follow-up to call the Lees back on Monday.”
  • “According to Horizline, what did we collect last month?”

When Grok asks to delete a record or change money, Horizline gives it a link instead of doing it. Open the link, signed in as yourself, read exactly what will happen, and choose Approve or Decline. An approval covers that one action, once, and expires after 15 minutes. Approve only what you asked for.

Everything Grok changes appears in the Activity Log under your name, with (AI assistant) after it.

Disconnecting

In Horizline, open Settings → Integrations → AI assistants, find the Grok connection and choose Disconnect. It stops working immediately. To take Horizline out of Grok as well, remove it from Grok’s connectors.

The connection also ends by itself when you change your Horizline password or two-step verification.

If something does not work

  • The menu has no Add connector: your Grok plan does not offer connectors. Nothing on the Horizline side can change that.
  • Grok cannot add the connector: check that the server URL is exactly https://mcp.horizline.app/mcp.
  • “This account cannot connect an assistant”: AI assistants are not switched on for your account, or you are a team member and the owner has not let team members connect their own. See Before you start.
  • “This connection request was stopped”: remove Horizline from Grok’s connectors, add it again from step 1, and start over.
  • “This request has expired”: the Horizline page is good for ten minutes. Start again from Grok.
  • Grok says it is not permitted: you left that kind of action unticked in step 4, or your account does not have the permission. Disconnect, then connect again to change what you ticked.