Your plans. Your AI.

Connect an assistant you already use to Hey Loz through MCP (Model Context Protocol). It can work with your events, guest lists, budgets, timelines, notes and other planning data. No Loz subscription is required and these tools use no Loz AI credits. Your AI provider’s own fees and account requirements may apply.

The server address

https://mcp.heyloz.com/mcp

Use the full address, including /mcp. Choose remote HTTP (Streamable HTTP) if your client asks for a transport. No local Laravel installation is needed.

Connect in three steps

  1. Sign in to your existing Hey Loz account, or create a free account.
  2. Add a custom remote MCP connection in your assistant. Name it Hey Loz and paste the server address above.
  3. Follow the Hey Loz sign-in and consent screen, review the requested permissions, then enable the connection in your conversation.

Try: “Show my Hey Loz events and the next tasks I need to do.” For changes, try: “Add a graduation party to Hey Loz called Sam’s graduation.”

ChatGPT

  1. Where available, enable Developer mode under Settings → Security and login.
  2. Open ChatGPT Plugins, select the plus button, and enter Hey Loz as the name. Under Connection, use the public MCP address above.
  3. Create the connection, sign in to Hey Loz when prompted, and review the discovered tools. Add the connection from the tools menu in a new conversation.

Availability depends on your ChatGPT account and workspace policy. This is a custom connection; it does not require a Hey Loz directory listing. See OpenAI’s connection instructions.

Claude

  1. Open Customize → Connectors and choose “Add custom connector” from the plus menu.
  2. Name it Hey Loz, enter the server address and add it. Follow Connect to sign in and approve access.
  3. Enable Hey Loz under Connectors in the conversation’s plus menu.

For a managed workspace, an owner may need to add the connector first. See Claude’s setup instructions for account availability and current menu names.

Claude Code

Run this in your terminal:

claude mcp add --transport http heyloz https://mcp.heyloz.com/mcp

Then open Claude Code and use /mcp to authenticate the Hey Loz server. See the Claude Code MCP guide.

Other agents and access tokens

Use the same URL with any client that supports remote MCP and OAuth. Support varies by app; a provider name alone does not guarantee custom MCP access.

If your client accepts a bearer token instead, open Dashboard → Connections. Create a named token, choose its expiry and whether to allow changes, then save the token shown once. Paste it into your client’s bearer-token field, or use this header with your own token in place of the placeholder:

Authorization: Bearer YOUR_HEY_LOZ_TOKEN

Keep the token in your client’s private credentials settings. Don’t paste it into a chat or a shared configuration file.

You choose the access

Read-only connections can inspect supported planning data. Read/write connections can create, edit and delete it across your account’s events. Some workspace reads initialize missing planning records and need write permission. File tools support attachments up to 2 MiB per call; use the dashboard for larger files.

MCP does not give an agent access to billing, phone messaging, hosted Loz AI calls or connection administration. Disconnect an app or token at any time from Connections. That stops future access; it cannot remove information already received by your assistant.

If it won’t connect

  • No custom-connection option: check your assistant’s plan and workspace policy using its official guide.
  • Sign-in or token error: reconnect through OAuth, or check whether your personal token expired or was disconnected.
  • Permission denied: check your connection’s access level. Updating or deleting plans needs write access.
  • No tools or connection timeout: check the exact HTTPS address, reconnect, and refresh the tool list. If the server is starting, retry after a short pause.
  • Different or missing events: confirm you connected the same Hey Loz account you use in the dashboard.