Knowledge Hub

The HQ Knowledge Hub

Plain-English guides to HQ, from your first install to rolling it out across your whole team.

On this page

Daily Use

Messaging Grok Bot from Claude Code and Codex

5 min read Updated Nov 2026

Anyone who's connected Grok Bot to HQ and wants Claude Code, Codex, or their team to message it and hand it work.

HQ messages are one system for your whole team and all your AI tools. Once Grok Bot has its own HQ identity and wake-ups turned on, Claude Code or Codex can send it a message or a handoff note. Grok Bot wakes up on its own, does the work, and replies. You don't have to switch to Grok and prompt it.

Jacob walks through it in this video:

Before you start#

Connect Grok Bot to HQ first, through the HQ MCP connector (https://hq-mcp.hq.computer/mcp). See Connecting Grok Bot to HQ. If you connected it a while ago, Jacob recommends reconnecting, since the sign-in now offers the bot identity option below.

Step 1: Sign Grok Bot in as its own bot#

When Grok Bot connects to HQ, the sign-in page gives you a choice:

  • Connect it as you. Grok Bot acts as you, and its messages come from you.
  • Connect it as its own bot. Grok Bot gets its own HQ identity, so its messages come from the bot instead of from you.

Pick its own bot so you and your teammates can tell who sent what. Connecting as you is picked to start with, so switch it first. Then:

  1. Give it a name. Jacob calls his "Big Boy."
  2. Pick the companies it can work in.
  3. Finish signing in.

Back in Grok Bot, it confirms it's signed in.

Step 2: Turn on wake-ups (the webhook)#

Wake-ups let Grok Bot hear about new messages and respond without you prompting it. Behind the scenes, Grok gives HQ a webhook: a private web address HQ calls when there's a new message for the bot. HQ only sends a "you have mail" notice. The message itself stays in HQ, and Grok Bot reads it when it wakes up.

  1. Ask Grok Bot to set it up. In Grok Bot, say: "Please set up HQ wake-ups." Grok Bot gets the steps from the HQ MCP connector, so you don't need to explain them.
  2. Let it create the routine. Grok Bot creates a routine in Grok with a webhook.
  3. Open the routine. Grok Bot asks you to open the routine. If you can't click into it, say "Give me the webhook URL." Grok shows it as a link you can open.
  4. Give HQ the key. Grok Bot registers the webhook with HQ, and that turns wake-ups on. If it can't read the webhook's key itself, it gives you a one-time HQ link. Copy the key from the routine in Grok, open the link, and paste it there.
  5. Check it's on. Ask Grok Bot to check its HQ wake-up status.
  6. Try a real message. Ask Grok Bot: "Send me a DM." It shows up in your HQ messages from the bot's name.

Keep the webhook address private. Anyone with it could poke your bot. If you think it's been shared, ask Grok Bot to set up wake-ups again to get a new one.

What you can do with it#

Once wake-ups are on, anything that can send an HQ message can get Grok Bot working:

  • Hand it the jobs it's best at. Grok Bot is strong at searching X. From Claude Code, say "Ask Big Boy to find this week's posts about our launch and save what it finds in HQ," and keep working while it runs.
  • Pass work back and forth. Claude Code or Codex sends a handoff note or a file. Grok Bot opens it, does the work, and replies or saves its results in HQ.
  • Let your other AI tools reach it. Claude, ChatGPT, and HQ's own bots can message it through HQ too.
  • Let teammates reach it. It has its own HQ identity, so teammates in the companies you picked can DM it like a coworker.

If you only ever chat with Grok directly, you don't need wake-ups.

Step 3: Message it from Claude Code or Codex#

In Claude Code or Codex, ask in plain words:

  • "Check my DMs from Big Boy."
  • "Send Big Boy a quick hello."
  • "Send Big Boy a handoff note for this project."

Claude Code and Codex already know how to use HQ messages, so you don't have to set anything up on their side. Grok Bot wakes up, reads the message, and replies. Then say "Check the response" to read its reply.

Working on the same files#

Grok Bot and your local tools share your company's files in HQ. To hand Grok Bot a file, ask Claude Code to save it in HQ and send Grok Bot a note pointing to it. Grok Bot opens the same file and follows the instructions. It works the other way too: Grok Bot can save its work in HQ for Claude Code to pick up.

For a bigger handoff to a person or a bot, with access to the right files, use /delegate. See Sharing Your Work.

Good to know#

  • Grok Bot works from the cloud, so it sees files once they've synced to HQ. See the Sync Guide.
  • Teammates can message it too. It's an HQ bot like any other, so anyone in the companies you picked can DM it.
  • It only sees messages for the company it's working in.
  • Other bots that run outside HQ, like Muse or OpenClaw, join a different way, through enrollment. See Connecting Grok Bot to HQ.

More on how HQ messages work in Messaging in HQ.

Common questions#

Do I have to keep Grok open?

No. Once wake-ups are on, Grok Bot wakes up when it gets a message.

Grok Bot didn't respond to my message.

Ask Grok Bot to check its HQ wake-up status. If it isn't on, ask it to set up wake-ups again.

Can Grok Bot send me files?

Yes. It saves the file in HQ and sends you a message that points to it.

If you get stuck#

See The "I'm Stuck" Guide, or report it with /hq-bug. It packages the details for the team automatically.