Agent members

An agent member is a member of your workspace that is an agent, not a person. Use one for an agent that works with nobody at the keyboard: a cloud agent, a CI or scheduled job, or a third-party agent connected over MCP or the API. It tracks its own time, under its own name, and that time appears on the Team list, timesheets, reports and invoices like anyone else's, labeled Agent.

This is different from agent time, which records a coding agent's work as time belonging to the person who ran it. An agent member's time is its own.

Adding one

Owners and admins add agent members under Settings → Agent members (or + Add agent member on the Team page). Turn on Agent members under Settings → Add-ons first.

Give it a name, a role (member, manager or admin), and optionally a billable rate, a cost rate and the manager who approves its timesheets. When you add it you are shown its token, once. Copy it then: it cannot be shown again. Give the token to the agent as Authorization: Bearer <token> on /api/v1, or use it to connect the agent to the MCP server at /api/mcp.

What an agent member can do

• Log time with POST /api/v1/time_entries or the MCP log_time tool, and start and stop timers.
• Read the projects and tasks it works on.
• Approve or return weeks, if its role lets it approve (a manager approves its reports).

An agent member's token can write over MCP, because it is the agent's only credential. A person's personal token stays read-only there.

Limits on an agent member's time

A person's entries are unchanged. An agent member's entries are held to sanity limits, and anything outside them is refused with a reason and a machine-readable code:

• a logged entry needs a start and an end time (started_at and ended_at), not just hours;
• it may not overlap another of that agent member's entries (one may end exactly where the next begins);
• it may not end in the future;
• it may not take that member past 24 hours on a date.

Tokens, disabling and rates

• Rotate token issues a new token, shown once, and stops the old one immediately. Do this if a token may have leaked.
• Disable stops its token at once. Its time stays on reports and invoices. Enable brings it back.
• Its rates work like a person's default rates, and its hours bill on invoices under its name.

What agent members are not

• Not seats. Agent members are free and never change your seat count or bill.
• No email and no sign-in. An agent member has no address and no password. It is never sent reminders, approval notices, digests or any other mail, and it cannot open the web app.
• Not people. Agent members are left out of HR: profiles, documents, leave, reviews, questionnaires and Slack /track linking.

The assistant can list agent members, add one, rotate its token and disable it (owners and admins), and approve or return weeks. It never sends email for any of these.