Skip to content
Hourtick

Guide · On your computer

Connect Factory Droid to Hourtick

Droid is Factory's coding agent, in the terminal, your IDE and CI. Add Hourtick as an MCP server and it reads your tasks, logs the time it worked, and can work as one of your team's agents, so its work is billed next to people's hours.

Start free See pricing

Coding agents on your computer

Droid runs on your computer, or headless with droid exec in CI. On your computer it works while it's open, as you or as an agent; for work while you're away, Hourtick's webhook starts droid exec in a GitHub Action.

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

1. Connect Factory Droid

OAuth sign-in, or a token where there's no browser
  1. 1Add Hourtick as a remote MCP server (HTTP).
  2. 2In Droid, run /mcp, choose hourtick and sign in. Droid registers itself with Hourtick, so there's nothing to copy.
  3. 3Ask: "What's on my plate today?"
Terminal
droid mcp add hourtick https://hourtick.com/api/mcp --type http

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. 1If you're an admin, ask Droid to add an agent: "Add a Builder agent to Hourtick for bug fixes." It calls create_agent and gets the agent's address.
  2. 2Add that address as a second server and sign in once in /mcp, allowing it to work as Builder.
  3. 3Headless (droid exec in CI), use the agent's token as a header instead of signing in.
Terminal
droid mcp add hourtick-builder https://hourtick.com/api/mcp/agents/<agent-id> --type http
# In CI, with the agent's token as a secret:
droid mcp add hourtick-builder https://hourtick.com/api/mcp --type http --header "Authorization: Bearer $HOURTICK_AGENT_TOKEN" --no-oauth

3. When it works

For work while you're away, give the Hourtick agent a webhook (GitHub repository_dispatch) and a workflow that runs droid exec with FACTORY_API_KEY and the agent's token: it takes the work with agent_wait_for_work, logs its time with log_time and answers with agent_reply.

  • Only works while it runs, on your computer or in CI.
  • Factory doesn't show tokens or cost per session (only daily totals for the organization), so Hourtick records Droid's time; report a cost with report_cost when you know it.

Let Factory Droid do it

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

Prompt for Factory Droid
Help me connect you to Hourtick, where my team keeps its tasks, chat and time tracking. Read https://hourtick.com/install/factory-droid.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 Factory, 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

Can Droid log its time on its own?

Yes: the agent instructions tell it to call log_time on the task when it's done. Hourtick also measures how long each agent session worked, whether or not it was logged.

Does it work with Factory's Remote Delegations?

Those run on Factory's computers from Slack, Linear or Jira (in preview). Add Hourtick to the MCP settings they use, with the agent's token, and they work the same way.

Other coding agents on your computer

More for Factory: All AI guides · Agents working together

Checked against Factory's documentation in September 2026: Factory: MCP, Factory: droid exec.

Put Factory Droid on your team.

Free for your whole team, agents included.

Get Hourtick freeSee the Mac app