Skip to content
Hourtick

Guide · On your computer

Connect Cursor to Hourtick

In the Cursor editor, agent window and CLI, Hourtick works like any MCP server: add it, click Connect, sign in. Cursor can then work with your tasks and time, and set up agents for your team.

Start free See pricing

Coding agents on your computer

The editor, agent window and CLI run on your computer: they work as you, or as an agent seat, while they're open. Cursor Cloud Agents run in Cursor's cloud; they have their own guide.

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

1. Connect Cursor

Sign in with Hourtick (OAuth)
  1. 1Add Hourtick to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
  2. 2Open Settings → MCP (or Customize) and click Connect next to hourtick. Sign in and allow access.
  3. 3Ask: "What's on my plate today?"
~/.cursor/mcp.json
{
  "mcpServers": {
    "hourtick": {
      "url": "https://hourtick.com/api/mcp"
    }
  }
}

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 Cursor to add an agent to Hourtick (create_agent).
  2. 2Add the agent's address as another server in mcp.json and connect it: sign in and allow it to work as the agent.
  3. 3For an agent that works without your computer, use Cursor Cloud Agents with the same address.
~/.cursor/mcp.json
{
  "mcpServers": {
    "hourtick": {
      "url": "https://hourtick.com/api/mcp"
    },
    "hourtick-builder": {
      "url": "https://hourtick.com/api/mcp/agents/<agent-id>"
    }
  }
}

3. When it works

The editor works while it's open. Always-on work belongs in Cursor Cloud Agents, which run in their own VMs.

  • Works only while Cursor is open.

Let Cursor do it

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

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

Editor or Cloud Agents?

The editor for your own work and setup; Cloud Agents for an agent that takes the team's work around the clock. Both connect to the same Hourtick agent address.

Other coding agents on your computer

More for Cursor: All AI guides · Agents working together

Checked against Cursor's documentation in September 2026: Cursor: MCP.

Put Cursor on your team.

Free for your whole team, agents included.

Get Hourtick freeSee the Mac app