Skip to content

How to set up Horizline inside ChatGPT

Add Horizline to ChatGPT as a plugin, so you can ask about your leads, jobs and invoices, and make changes, from a ChatGPT conversation.

Updated

ChatGPT 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 ChatGPT side, step by step.

The screens below are ChatGPT’s own, captured in November 2026. ChatGPT 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 ChatGPT, you need an account that can add a custom MCP server. If the menu in step 2 has no Add custom MCP server, your ChatGPT plan, or whoever manages your ChatGPT workspace, does not allow it.

1. Open Plugins

In ChatGPT’s sidebar, choose Plugins.

ChatGPT's sidebar, listing New chat, Scheduled, Library, Plugins and Explore.
ChatGPT’s sidebar.

2. Add a custom MCP server

MCP is the standard AI assistants use to connect to other services, and Horizline has an MCP server for your account. On the Plugins page, choose Add at the top right.

ChatGPT's Plugins page: the heading Plugins, a search field, and the Add button at the top right beside the settings icon.
The Plugins page. Add is at the top right.

From the menu that opens, choose Add custom MCP server.

The Add custom MCP server item in the Add menu.
In the Add menu.

3. Fill in the form

ChatGPT opens a form called Add custom MCP server. Fill it in like this:

  • Icon (optional): ChatGPT takes a PNG of up to 10 KB. Download Horizline’s icon (256 × 256, 3 KB) and add it, or leave this empty.
  • Name: Horizline
  • Description (optional): a few words, such as My Horizline CRM: leads, clients, jobs and invoices.
  • Connection: leave Server URL selected, not Tunnel, and enter Horizline’s server address. It is also in Horizline under Settings → Integrations → AI assistants.
    https://mcp.horizline.app/mcp
  • Authentication: OAuth.
  • Advanced OAuth settings: leave them as they are. ChatGPT reads Horizline’s sign-in settings from the address and identifies itself to Horizline.

Read ChatGPT’s warning, tick I understand and want to continue, and choose Create as a plugin.

The Add custom MCP server form filled in: Name Horizline, Connection set to Server URL with https://mcp.horizline.app/mcp, Authentication OAuth, and I understand and want to continue ticked, with Create as a plugin chosen.
The form filled in for Horizline.

ChatGPT shows that warning for every custom server, and it is right to: connect only services you trust. With Horizline, ChatGPT gets no more than your own account can do, and the parts that cannot be undone wait for you on a Horizline page.

4. Approve the connection in Horizline

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

  1. Check who is asking. The page names the application and where access is sent; both should be ChatGPT’s, at chatgpt.com. If you did not just add Horizline in ChatGPT, choose Cancel.
  2. Under What it may do, untick anything you do not want ChatGPT 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. The page says Horizline is connected and takes you back to ChatGPT.

5. Ask ChatGPT

Start a new chat and ask for something in your Horizline account. Naming Horizline helps ChatGPT 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 ChatGPT 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 ChatGPT changes appears in the Activity Log under your name, with (AI assistant) after it.

Disconnecting

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

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

If something does not work

  • The Add menu has no Add custom MCP server: your ChatGPT plan or workspace does not allow custom servers. Nothing on the Horizline side can change that.
  • ChatGPT cannot create the plugin: check that the address is exactly https://mcp.horizline.app/mcp, with Server URL selected and Authentication set to OAuth.
  • “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 ChatGPT’s Plugins page, add it again from step 1, and start over.
  • “This request has expired”: the Horizline page is good for ten minutes. Start again from ChatGPT.
  • ChatGPT 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.