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.
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.
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.
2. Choose Custom
Grok opens New Connector. Choose Custom, Add your own custom connector, 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.
4. Approve the connection in Horizline
Grok opens a Horizline page. Sign in if asked. You never give Grok your Horizline password.
- Check who is asking. The page names the application, which should be Grok. If you did not just add Horizline in Grok, choose Cancel.
- 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.
- Choose Connect at the bottom of the page. It says Horizline is connected and takes you back to 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.