EN
Log in Start for free

Claude Code integration

Live chat on your site with Claude Code

Claude Code works in your project’s files. Give it the Hooky prompt: it finds the shared template and adds the chat bubble. Then connect Hooky’s MCP server, and ask it for your conversations, your stats or a new site without leaving the terminal.

Two ways to connect Hooky to Claude Code

The first one is all you need to have chat on your site: one prompt, and Claude Code adds one line to your template. The second goes further: with the MCP server, Claude Code talks directly to your Hooky account. It creates a site, fetches its tag, reads your conversations, turns on the AI agent… You can do either without the other.

Using Claude on claude.ai rather than in the terminal? The Claude guide covers the prompt in a conversation and the Hooky connector.

Install the bubble with a prompt

  1. Create your Hooky account (free for one site), add your site and copy its prompt from Sites: the key is already in it.

  2. Start Claude Code at the root of your project (claude in the terminal, or from your editor).

  3. Paste the prompt. Claude Code looks for the template shared by every page and adds the tag. Review the change it proposes: only one line should appear (two with the import for Next.js).

  4. Deploy as usual: commit, push, or your host’s command. Open your live site: the bubble is at the bottom of the screen.

The prompt for Claude Code

Add the Hooky chat bubble to this site, on every page. Find the HTML template shared by every page (index.html for React or Vite, app/layout.tsx for Next.js with the Script component from next/script and strategy="afterInteractive", the base layout for Astro, Nuxt, SvelteKit, Rails or Django) and paste this tag there once, right before </body>:

<script src="https://heyhooky.com/widget.js" data-site-key="SITE_PUBLIC_KEY" async></script>

Don’t change the script URL or the data-site-key attribute. Don’t add any other code: the bubble shows up on its own. If the site has several independent templates, add the tag to each and tell me which ones.

To test on your development server, add localhost to the site’s allowed addresses in Hooky (every port is covered).

Connect Hooky’s MCP server

Hooky’s MCP server lives at https://api.heyhooky.com/mcp (HTTP transport). You add it once, then sign in with your Hooky account: no key to copy.

  1. Add the server in a terminal:

    claude mcp add --transport http hooky https://api.heyhooky.com/mcp

    By default, the server only applies to the current project. To have it in all your projects, add --scope user.

  2. Sign in: in Claude Code, type /mcp, pick hooky and follow the steps. A Hooky page opens in your browser: sign in (or create your account), pick the account and allow access.

  3. Check: claude mcp list in the terminal, or /mcp in Claude Code, shows hooky connected. Claude Code then sees Hooky’s tools (sites, conversations, channels, stats, AI agent).

Prefer an API key? Create one in Developers and pass it as a header (the Developers page gives you the command with your key):

claude mcp add --transport http hooky https://api.heyhooky.com/mcp --header "Authorization: Bearer hka_your_api_key"

With --scope project, the configuration goes into the project’s .mcp.json file, shared with your team: don’t put a key in it, let everyone sign in with /mcp. Everything is detailed in the MCP server docs.

What you can ask Claude Code

  • “Add the Hooky chat to this project”: it creates the site in your account (or finds the existing one), fetches its tag and adds it to your template.
  • “Summarize yesterday’s conversations”: it reads your conversations and tells you who wrote, about what, and what is waiting for a reply.
  • “Turn on my site’s AI agent”: on paid plans, it switches it on, tells it which page to read and can add your instructions (hours, shipping, returns…).
  • “Make the bubble blue and move it to the bottom left”: color, side, style and greeting are set without opening the dashboard.
  • “How many signups this week?”: it reads your Hooky stats, including events counted with Hooky.track (docs).
  • “Draft a reply to the latest visitor”: it writes it, shows it to you, and only sends it with your OK.

Stay in control

A reply sent by Claude Code really reaches your visitor, signed with your name: Claude Code should show it to you first. Signing in creates a key named after the tool in Developers; remove it to cut off access. And you keep replying yourself from the Hooky app (iPhone, iPad, Mac, Android) or the web dashboard.

Frequently asked questions

Do I need the MCP server to have chat on my site?

No. The prompt is enough: the bubble only needs its tag. The MCP server is for managing your Hooky account from Claude Code.

I don’t have a Hooky account yet

Run /mcp: the sign-in page offers to create your account, then you allow Claude Code. Without MCP, Claude Code can also create your account through the signup API: tell it “Read https://heyhooky.com/llms.txt, then create a Hooky account with my email and install the bubble” (see the docs).

/mcp doesn’t show hooky

The server may have been added in another project: the default choice only applies to the folder where you added it. Run claude mcp list in your project, or add it with --scope user.

What about claude.ai or the Claude app?

Hooky is added there as a connector, with the same address. See the Claude guide and the docs.

How do I cut off Claude Code’s access?

Remove its key in Developers, on the Hooky side. On the Claude Code side, claude mcp remove hooky removes the server.

Other tools

Your visitors have questions. Answer them from wherever you are.

Free for one site, installed with one prompt. Then just keep your phone in your pocket.