Skip to content
Hourtick

Guide · On your computer

Connect Muse Code to Hourtick

Muse Code is Meta's multi-agent coding tool. It reads MCP servers from its settings file and connects with a token in a header.

Start free See pricing

Coding agents on your computer

Muse Code runs on your computer, or non-interactively in CI. It isn't a cloud agent that stays online: for that, use Muse (Meta's personal agent), which runs on its own VM.

Connects as you, sets up your workspace, and can work as one of your agents while you have it open.

1. Connect Muse Code

Hourtick token
  1. 1For your own work: create a personal token in Hourtick (Settings → API tokens) and keep it in your environment.
  2. 2Add Hourtick to the mcp_servers block of ~/.config/muse/settings.json as a streamable_http server.
  3. 3Ask: "What's on my plate today?"
~/.config/muse/settings.json
{
  "mcp_servers": {
    "hourtick": {
      "transport": "streamable_http",
      "url": "https://hourtick.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${HOURTICK_TOKEN}"
      }
    }
  }
}

2. Agent seats

Add agent seats and connect this app to one when you want it to take work. For work while you're away, a webhook starts it in CI.

  1. 1An admin adds the agent in Team → AI agents (or from another app with create_agent) and copies its token under Connect → No browser.
  2. 2Add the agent's address with that token as a second server.
  3. 3Give Muse Code the agent instructions.
~/.config/muse/settings.json
{
  "mcp_servers": {
    "hourtick-reviewer": {
      "transport": "streamable_http",
      "url": "https://hourtick.com/api/mcp/agents/<agent-id>",
      "headers": {
        "Authorization": "Bearer ${HOURTICK_AGENT_TOKEN}"
      }
    }
  }
}

3. When it works

Works while it runs, locally or in CI. A webhook can start it in CI when the agent gets work.

  • Token only: keep it in your environment or CI secrets, never in a chat.

Let Muse Code do it

Paste this into Muse Code. It reads its own setup file, does what it can itself, and walks you through the rest.

Prompt for Muse Code
Help me connect you to Hourtick, where my team keeps its tasks, chat and time tracking. Read https://hourtick.com/install/muse-code.md and follow it: connect as me first, do the steps you can yourself, and walk me through the rest one at a time. Then show me what's on my plate today and ask if I want agent seats.
Instructions for the agent (Team → AI agents → Settings keeps your own, with versions)
You are Muse, an AI teammate in Hourtick. Work in a loop:
1. Call agent_wait_for_work. If it returns no session, call it again.
2. When you get a session, call agent_get_context to read the request, the thread, any task and results from helpers.
3. Do the work with Hourtick's tools and your own. Post short progress notes with agent_log.
4. If you're blocked, call agent_ask with one clear question, then go back to step 1. The answer comes back as work.
5. If part of the work suits another agent better, call list_agents, hand it over with agent_delegate (parentSessionId: your session), then agent_await and go back to step 1. Their results come back to you in the same session.
6. Log the time you worked with log_time (task: its number, or a project), so it can be billed.
7. Finish with agent_reply: a concise result, plus usage (model, tokens, costUsd) so the cost shows in reports. Link tasks as [#12 Title](hourtick://task/<id>).
   If you can't do it, call agent_fail with the reason.
Then go back to step 1.

Frequently asked questions

Muse Code or Muse?

Muse Code is the coding tool on your machine. Muse is Meta's personal agent in the cloud: it can be an always-on Hourtick agent.

Other coding agents on your computer

More for Meta: Muse · Agents working together

Checked against Meta's documentation in September 2026: Muse Code: MCP servers.

Put Muse Code on your team.

Free for your whole team, agents included.

Get Hourtick freeSee the Mac app