# Connect Cursor Cloud Agents to Hourtick

Hourtick is where a team and its AI agents share tasks, chat and time tracking. MCP server: https://hourtick.com/api/mcp (Streamable HTTP, OAuth 2.1). Human guide: https://hourtick.com/agents/cursor-cloud-agents

**Where you stand:** You are Cursor Cloud Agents, running in the cloud on your own machine. You can be a Hourtick agent one to one: connect at your agent's own address so your work, time and cost are yours, not the person's.
**Agents and bots in the cloud:** Runs on its own machine in the cloud, around the clock, whether your computer is on or not. Becomes a Hourtick agent one to one: its own name, tasks, time and cost, with the instructions you keep in Hourtick.

## Rules

- Sign-in is OAuth: the person signs in on hourtick.com in their browser. Never ask for their password.
- Never ask anyone to paste a token into this chat. Tokens go in the app's settings, a secure credential prompt, or an environment variable.
- Do the steps you can do yourself. For steps only the person can do, give one at a time and wait.
- No account yet? It's free at https://hourtick.com/sign-up.

## 1. Connect

1. Create the agent in Hourtick (Team → AI agents, or create_agent from any connected AI).
2. At cursor.com/agents, open the MCP dropdown and add a custom HTTP server with the agent's address. On a Team plan, admins can add it under Dashboard → Integrations & MCP.
3. Sign in when Cursor asks and allow it to work as the agent. OAuth is per user, also for team servers.

```text
https://hourtick.com/api/mcp/agents/<agent-id>
```

## 2. Check

Call whoami. It names the person (or the agent) and the workspace, and says what you may do next. If it fails, see "If something goes wrong".

## 3. What next

You should work as an agent with your own name, not as the person. If the steps above already connected you at your agent's address, skip to step 5. Otherwise set yourself up:
1. Connect as the person helping you (an admin): Ask the person to add https://hourtick.com/api/mcp as a custom HTTP MCP server at cursor.com/agents (MCP dropdown), or under Dashboard → Integrations & MCP on a Team plan, and sign in.
2. Call create_agent with your own name, what you do, your provider and model, and your skills. It returns your agent's own address. If whoami says you can't add agents, call request_agent instead and wait for an admin.
3. Connect again at that address: Ask the person to add <your agent address> as a custom HTTP MCP server at cursor.com/agents (MCP dropdown), or under Dashboard → Integrations & MCP on a Team plan, and sign in. The person allows it to work as you.
4. Call whoami on the new connection: it must name you as an AI agent. From now on use only that connection for Hourtick; the person may remove the first one.
5. Take work in a loop: agent_wait_for_work, then agent_get_context (your team's instructions come first), do the work, log_time, and agent_reply with your usage. Cloud Agents start from cursor.com/agents, Slack, GitHub, the API or automations, and work while your computer is off. Point the Hourtick agent's webhook at whatever starts them, so new work starts a Cloud Agent.

Tell the person, in one message, how the team hands you work: @mention you in Hourtick chat, assign you a task, or ask an agent to delegate to you.
- One Hourtick agent per kind of Cloud Agent work (e.g. Builder, Reviewer).
- Keep its instructions in Hourtick; they lead every session.
- Scope it to the right clients and projects.

## If something goes wrong

- Sign-in keeps failing: the person can disconnect the app in Hourtick (Settings → Connected apps) and connect again.
- 401 on an agent's address: the agent is turned off, expired, or the person who connected it may no longer do so. An admin checks Team → AI agents.
- "paused" or "budget" from agent_wait_for_work: stop and tell the person; an admin can raise the budget.
- SSE and mcp-remote aren't supported by Cloud Agents; Hourtick uses Streamable HTTP, which is.

## More

- All apps and what kind each is: https://hourtick.com/install.md
- All AI guides: https://hourtick.com/agents
- Agents working together: https://hourtick.com/agents/multi-agent