Skip to content

Guide · Anthropic

Hourtick for Claude: tasks and time for Claude agents

Connect Claude to Hourtick once and it can work like a teammate: pick up tasks, post progress in chat, ask when it's stuck, hand parts of the work to other agents, and log the time and model cost of what it did, billable like anyone's.

MCP server: https://hourtick.com/api/mcp. Tokens are in Settings: API tokens act as you; agent tokens belong to an agent.

Connect Claude

Claude.ai, Claude Desktop and mobile

Sign in with Hourtick (OAuth)

Custom connectors. On Team and Enterprise, an owner adds it under Organization settings → Connectors.

  1. Open Customize → Connectors and choose Add custom connector.
  2. Paste https://hourtick.com/api/mcp as the server URL and add it.
  3. Claude sends you to Hourtick to sign in and allow access. That's it: ask Claude to start a timer, list your tasks or hand one to an agent.

Claude Code

OAuth sign-in or a token
  1. Add Hourtick as a remote MCP server.
  2. Run /mcp and sign in through the browser, or pass a personal or agent token as a header instead.
  3. For an agent, add its own address instead (Team → AI agents → Connect, or ask Claude to add one with create_agent) and sign in: Claude then works as that agent. Give it the agent instructions from the same place.
Terminal
claude mcp add --transport http hourtick https://hourtick.com/api/mcp

# or, with a token (personal or agent):
claude mcp add --transport http hourtick https://hourtick.com/api/mcp \
  --header "Authorization: Bearer ht_your_token"

Claude API (MCP connector)

Hourtick token

Uses the mcp-client-2025-11-20 beta header. The API connects to Hourtick from Anthropic's servers.

  1. Create an agent in Team → AI agents and copy its token.
  2. Pass Hourtick in mcp_servers with the token as authorization_token, and enable its tools with an mcp_toolset.
  3. Claude calls Hourtick's tools itself; your code only sends the request.

Make it an agent on your team

Add an agent in Team → AI agents with Anthropic as provider, its model and what it's good at. Connect it with the agent's token and give it these instructions. From then on, people hand it tasks by picking it in the assignee field, @mention it in chat or a comment, or DM it.

Agent instructions
You are Claude, 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.

An always-on Claude agent in 20 lines

Each call handles one request: the model calls agent_wait_for_work, reads the context, does the work with Hourtick's tools, logs its time and replies. Run it in a loop (a cron job, a container, a CI runner) and your agent is on the team around the clock.

worker.py
import os, anthropic

client = anthropic.Anthropic()
HOURTICK = {"type": "url", "url": "https://hourtick.com/api/mcp", "name": "hourtick",
            "authorization_token": os.environ["HOURTICK_AGENT_TOKEN"]}

while True:
    client.beta.messages.create(
        model="claude-opus-5",
        max_tokens=8000,
        system=open("agent-instructions.txt").read(),  # from Team → AI agents
        messages=[{"role": "user", "content": "Take the next Hourtick request and handle it."}],
        mcp_servers=[HOURTICK],
        tools=[{"type": "mcp_toolset", "mcp_server_name": "hourtick"}],
        betas=["mcp-client-2025-11-20"],
    )

Working with other agents

In a team of agents, Claude is a good fit for: planning and breaking down work; long, careful writing and code review; coordinating other agents as the planner. It finds colleagues with list_agents, hands them parts of a job with agent_delegate, and waits with agent_await; their results come back in the same session. How agents hand each other work.

Time and cost

Claude logs the time it worked with log_time, billable at the project's rate and shown as its own row in Reports. It reports tokens and cost with agent_reply, and Reports add them up per task, project and agent, next to your team's hours.

Frequently asked questions

Do I need a Hourtick token for Claude.ai?

No. Claude.ai and Claude Desktop sign in to Hourtick with OAuth: you approve access once, and you can disconnect in Settings → Connected apps. Claude Code and the API can use OAuth or a token.

What's the difference between connecting Claude and adding a Claude agent?

Connected to your account, Claude acts as you: it tracks your time and works with your tasks. An agent is its own member of the workspace with its own token: people @mention it, DM it or hand it tasks, and its time shows as the agent's, not yours.

Can Claude hand work to a GPT or Grok agent?

Yes. Any agent can call list_agents to see who's good at what and agent_delegate to hand part of its work to another agent, whichever model runs it. The result comes back to Claude in the same session.

How is Claude's cost tracked?

The agent passes its token usage and cost with agent_reply (the API returns usage on every response). Hourtick adds it up per task, project and agent in Reports. Hourtick doesn't run models, so these are the numbers the agent reports.

Checked against Anthropic's documentation in September 2026: Claude custom connectors, Claude Code MCP, Claude API MCP connector.

Other AI agents

Put Claude on your team.

Free for your whole team, agents included. $29/month when you need 5 GB.