add_automation
ChatGPTAdds an automation to a field, switched off. A rule the organization already has is refused. read_guide("automations") has the vocabulary and when to use it.
add_dependency
ChatGPTMakes items depend on others, in order; add many links in one call. With the default type FS the item can start once dependsOn finishes; SS means it can start once dependsOn starts, FF that it can finish once dependsOn finishes, and SF that it can finish once dependsOn starts. lagDays adds working days between the two, or overlaps them when negative. If the link already exists, its type and lag are changed. Adding a link here does not reschedule either item. Answers added with the id, display id and title of each waiting item, and refused with the index of each link that was not added and why.
add_holidays
ChatGPTAdds organization holidays. Each one is a day off for everyone and a non-working day in every plan, so confirm the list with the user first. Existing plans keep their dates. Answers added with each holiday, and refused with the index of each one that was not added and why.
add_team_members
ChatGPTAdds people already in the organization to a team. Someone already in it stays as they are. Answers added with each person, and refused with the index of each one who was not added and why.
add_time_off
ChatGPTBooks time off or reduced hours, in order. Each entry sets the hours a person works on every day of a range. A team's entry closes the team for all its members and must be 0 hours. Changing someone else's time off needs a role that may change other people's capacity. Organization holidays are add_holidays. Answers added with each entry, and refused with the index of each entry that was not booked and why.
assign_role
ChatGPTGives people a role in the organization, which decides what they may see and change. Only an administrator can, and the last active administrator cannot be given another role. What a role allows is changed in the app, not here. Confirm the people and the role with the user first. Answers assigned with each person, and refused with the index of each one whose role did not change and why.
create_allocation
ChatGPTPlans hours for people, in order. A shaped entry sets a person's hours on one item in place of the hours the app spreads from the item's estimate, and its segments count from the item's start date. A reserved entry holds time over its own dates, optionally for an item, on top of other work. A segment covers every calendar day from fromDay to toDay, weekends included, so leave gaps for the days the person does not work: read their week with get_capacity, and their days off with list_time_off and list_holidays, first. Answers created with each row, and refused with the index of each entry that was not planned and why.
create_field
ChatGPTCreates a field. A select field takes its options here, in order; a relation field names the types it may point at; a formula field takes its formula. Agree the field and its options with the user first.
create_item
ChatGPTCreates items, in order; create many in one call rather than one call per item. Field values are keyed by field key; a select takes an option label (an unknown label creates the option when your role allows), a people field takes a user id or {"email": "..."}, a date takes YYYY-MM-DD. Fields you leave out take the type's defaults. To create a hierarchy in one call, give a parent a ref and its children that ref as parentRef, parent first. Each item is created on its own: answers created with the id, display id and title of each, and refused with the index of each item that was not created and why.
create_rate
ChatGPTAdds internal cost rates, in order: what the organization, a team or a person costs per hour from a date, until the next rate for the same one. Budget cost figures change with them, so confirm the amounts with the user first. Needs a role that may change rates. Answers created with each rate, and refused with the index of each one that was not added and why.
create_team
ChatGPTCreates a team, optionally inside another team. A team can be assigned work and given access like a person.
create_template
ChatGPTCreates an item template from a list of items: the first is the item the template creates, and every other item sits under one before it, named by parentRef. Dates are working days from the day it is used. It is shared with the whole organization, so agree it with the user first.
create_type
ChatGPTCreates an item type, such as Epic, Client or Deliverable. It gets its own display ids, with a prefix made from its name, and every field that applies to all types. Agree the name and key with the user first.
create_view
ChatGPTCreates a list, board or Gantt view with one tab, at the top of the sidebar or of a folder. It is private unless audience is everyone. Without childTypes, each type brings the types it allows under it. Name fields by their keys from describe_organization and values by their labels: option labels, emails or @me, team names, display ids, type keys. Built-in columns: title, type, displayId, dateCreated, dateUpdated, dependencies, wbs, predecessors, successors. A name that matches nothing is refused with what was not found. A view id is not an item: never pass one to the item tools.
deactivate_people
ChatGPTDeactivates people, so they can no longer sign in and their personal tokens stop working. Their work, assignments and history stay, and an administrator can reactivate them in the app. Only an administrator can, and nobody can deactivate themselves. A person invited but not yet joined is refused: revoke_invite withdraws the invitation. Confirm with the user before calling this. Answers deactivated with each person, and refused with the index of each one who was not deactivated and why.
delete_allocation
ChatGPTDeletes planned hours. A deleted shaped row hands the item back to the hours the app spreads from its estimate. Confirm with the user before calling this. Answers deleted with each id, and refused with the index of each one that was not deleted and why.
delete_attachment
ChatGPTDeletes attachments from their items. Confirm with the user before calling this. Answers deleted with each file's id and name, and refused with the index of each one that was not deleted and why.
delete_automation
ChatGPTDeletes an automation. This cannot be undone here. Confirm with the user first.
delete_capacity
ChatGPTDeletes working weeks. The days one covered fall back to the person's earlier week, or to the organization's default. Confirm with the user before calling this. Answers deleted with each id, and refused with the index of each one that was not deleted and why.
delete_field
ChatGPTDeletes a field. A field that items hold values for is refused unless orphanValues is true; those values then stay on the items where nothing can show them. This cannot be undone here. Confirm with the user first.
delete_holidays
ChatGPTDeletes organization holidays, so those days are working days again. Confirm with the user before calling this. Answers deleted with each id, and refused with the index of each one that was not deleted and why.
delete_item
ChatGPTMoves items, and everything under each of them, to the organization's trash, where they can be restored for 30 days. Confirm with the user before calling this. Answers deleted with the id of each item, and refused with the index of each item that was not deleted and why.
delete_rate
ChatGPTDeletes cost rates. The days a rate covered fall back to the same one's earlier rate, then to a team rate, then to the organization's. Confirm with the user before calling this. Answers deleted with each id, and refused with the index of each one that was not deleted and why.
delete_team
ChatGPTDeletes a team. Its members stay in the organization, the teams inside it move up a level, and work assigned to the team loses that assignee. Confirm with the user before calling this.
delete_template
ChatGPTDeletes an item template. Items already created from it stay. This cannot be undone here. Confirm with the user before calling this.
delete_time_log
ChatGPTDeletes time logs. Confirm with the user before calling this. Answers deleted with the id of each time log, and refused with the index of each time log that was not deleted and why.
delete_time_off
ChatGPTDeletes time off, so those days are worked as usual again. Confirm with the user before calling this. Answers deleted with each id, and refused with the index of each one that was not deleted and why.
delete_type
ChatGPTDeletes an item type. A type that still has items is refused unless deleteItems is true, which deletes those items with it. This cannot be undone here. Confirm with the user before calling this.
delete_view
ChatGPTDeletes a view for everyone who sees it; a folder is deleted with every view in it. The items it showed are kept. Answers with every view deleted. No tool restores a deleted view. Confirm with the user before calling this.
describe_organization
ChatGPTCall this first. Returns who you are acting as, what this connection may do, the roles people can be invited with, and every item type you can see with its child types, its field keys and field types, the allowed values of each select field, and each formula and display format.
get_capacity
ChatGPTReads contracted working hours. Each row is a weekly pattern, weekday 1 (Monday) to 7 (Sunday) in hours, in force from its effectiveFrom date until the next row for the same person or team. Days off and reduced hours over a date range are in list_time_off.
get_item
ChatGPTReads items, each with its description and every field value; ask for many in one call. Answers items, and refused with the index of each one that was not found and why.
get_item_history
ChatGPTReads an item's change history, newest first: who changed what, when, and from where.
get_rates
ChatGPTReads internal cost rates: what the organization, a team or a person costs per hour, in the organization's currency. Each row is in force from its effectiveFrom date until the next row for the same person, team or organization; an effectiveFrom of 1900-01-01 means the rate applies from the start. Needs a role that may read rates. These are the inputs to the app's budget figures, which the app computes itself and no tool returns, so do not present hours multiplied by a rate as the app's cost.
get_timesheet
ChatGPTReads the time logged over a period, one person's or everyone's, newest day first: each log with its day, minutes, who logged it, and the item or tracked-time category it was logged on. Pass category to read only the time on one category, such as Meetings. Time on items in the trash, or on items of a type you cannot read, is left out.
get_view
ChatGPTReads one view: who sees it, the types it shows, and each tab's kind, columns, filters, grouping, sort and board columns, in the words create_view and update_view take. A setting those words cannot state is named under undescribed. Name fields by their keys from describe_organization and values by their labels: option labels, emails or @me, team names, display ids, type keys. Built-in columns: title, type, displayId, dateCreated, dateUpdated, dependencies, wbs, predecessors, successors. A name that matches nothing is refused with what was not found. A view id is not an item: never pass one to the item tools.
invite_people
ChatGPTInvites people to the organization by email, all with the same role and teams. A first and last name are optional; they show until the person accepts, and fill in the form they accept with. Each gets an email with a link to join. Returns each invited person's user id: work can be assigned to it right away, and stays theirs when they accept. Confirm the addresses and the role with the user first.
list_allocations
ChatGPTLists hours explicitly planned for people. A shaped row sets a person's hours on one item, and its segment offsets count calendar days from the item's start date. A reserved row holds time over its own dates, optionally for an item. This is not a person's whole workload: the app also spreads each task's estimate over its working days for its assignees, and those hours are not stored, so they are not listed here.
list_attachments
ChatGPTLists the files attached to an item, newest first.
list_automations
ChatGPTLists automations, every field's or one field's: each with its ruleId, whether it is on, a sentence saying what it does, and its vocabulary, or advanced / readOnly when it cannot be stated or changed. read_guide("automations") has the vocabulary and when to use it.
list_holidays
ChatGPTLists the organization's holidays: days nobody works, which scheduling skips like a weekend. A holiday that repeats every year is listed once, at its first occurrence, with repeatsYearly set.
list_invites
ChatGPTLists the invitations nobody has accepted yet, expired ones included, with the role and teams each offers.
list_people
ChatGPTLists the organization's people and teams, for assigning people or finding a user id. A person's status is active, inactive, or pending: invited and not yet joined. A pending person can be assigned work, and keeps it on joining.
list_templates
ChatGPTLists the organization's item templates: saved items, with the items under them, that create_item can create together by naming the template. Each shows its type, whether it is its type's default, and how many items it creates. Ask for includeItems to see every item it holds, in the shape create_template takes.
list_time_logs
ChatGPTReads the time logged on an item.
list_time_off
ChatGPTLists time off and reduced hours. Each row sets the hours a person or team works per day over a date range: 0 is a day off, 4 a half day. A team's rows are its public holidays.
list_views
ChatGPTLists the views and folders you can see, in sidebar order, each view with its tabs (title, kind, which is the default). A view is a saved list, board or Gantt of items; it is addressed by id or display id. A view id is not an item: never pass one to the item tools.
log_time
ChatGPTLogs time you spent on items, in order; log many entries in one call. When an item's type has more than one tracked-time field, name the one to log against with field (its key from describe_organization). Answers logged with the id of each time log, and refused with the index of each entry that was not logged and why.
read_attachment
ChatGPTReads one attachment: an image (PNG, JPEG, GIF or WebP) comes back as an image, and a text file (.txt, .csv, .tsv, .md, .json, .xml, .yaml or .log) as its text. Other files, such as PDFs or spreadsheets, cannot be read here.
read_guide
ChatGPTReads the rules for one topic before you act on it. Topics: views (making, changing and sharing saved views).
remove_dependency
ChatGPTRemoves the links that make items depend on others, in order. Removing a link does not reschedule either item. Answers removed with the id, display id and title of each waiting item, and refused with the index of each link that was not removed and why.
remove_team_members
ChatGPTRemoves people from a team. They stay in the organization, and work assigned to them stays theirs. Answers removed with each person, and refused with the index of each one who was not removed and why.
rename_attachment
ChatGPTRenames attachments. Answers renamed with each file's id and new name, and refused with the index of each one that was not renamed and why.
revoke_invite
ChatGPTWithdraws the invitations sent to an email address, so its link no longer lets anyone join. Work assigned to the invited person then shows as Deleted user, and inviting the address again gives a new user id.
search_help
ChatGPTSearches Teamhood's help articles for how a feature works or how to do something in the app.
search_items
ChatGPTFinds items. Every filter is optional and they combine with AND. filters is keyed by field key (from describe_organization) or title / watchers; a value is either the value to match or an object of operators: eq, ne, gt, gte, lt, lte, contains, in (an array), exists (true/false). Select fields match by option label. Returns compact items and a nextCursor for the next page.
set_capacity
ChatGPTSets people's contracted working hours from a date, in order. Each entry is a weekly pattern in force from effectiveFrom until that person's next one, so earlier weeks keep their hours; to correct an existing pattern, use update_capacity. Only a person has one: a team's capacity is the sum of its members'. Changing someone else's hours needs a role that may change other people's capacity. Answers set with each pattern, and refused with the index of each entry that was not set and why.
update_allocation
ChatGPTChanges planned hours, in order: the dates of a reserved row, the hours, whether they are firm, or the label. Only what you pass changes, and segments replace all the old ones. Answers updated with each row, and refused with the index of each change that was not made and why.
update_automation
ChatGPTChanges an automation. Pass exactly one of automation, which replaces the rule and switches it off, or enabled, which only switches it on or off. An advanced or readOnly automation can only be switched. read_guide("automations") has the vocabulary and when to use it.
update_capacity
ChatGPTCorrects working weeks, in order: the date one applies from, or its hours, which replace the whole week. Answers updated with each pattern, and refused with the index of each change that was not made and why.
update_field
ChatGPTChanges a field. Only what you pass changes. Options are added, changed and removed by label, so the items holding an option keep it through a rename. An option that items outside the trash hold cannot be removed, or narrowed away from a type whose items hold it: move those items to another option with update_item first.
update_holidays
ChatGPTRenames, moves or changes the repeat of organization holidays. Only what you pass changes. Answers updated with each holiday, and refused with the index of each one that was not updated and why.
update_item
ChatGPTChanges items, in order; change many in one call rather than one call per item. For each, only what you pass changes: fields merges, and a field set to null is cleared. Set parentId to move the item under another item, or to root to make it top-level. Add or remove watchers, who are notified of new comments, by naming people as me, an email address, a name or an id. The type cannot be changed here. Each change is made on its own: answers updated with the id, display id and title of each item, and refused with the index of each change that was not made and why.
update_rate
ChatGPTChanges cost rates, in order: the amount, or the date a rate applies from. A rate's person, team or organization never changes; add a rate instead. Answers updated with each rate, and refused with the index of each change that was not made and why.
update_team
ChatGPTRenames, recolours or moves a team. Only what you pass changes.
update_template
ChatGPTRenames an item template, makes it its type's default or not, or replaces its items. Items replace the whole list: read it with list_templates includeItems, change it, and pass every item back. An item passed back with its ref keeps its description unless you change it.
update_time_log
ChatGPTCorrects time logs, in order: how long, which day, or what each was for. Only what you pass changes. Answers updated with the id of each time log, and refused with the index of each correction that was not made and why.
update_time_off
ChatGPTMoves time off or changes its hours or reason, in order. Only what you pass changes. Answers updated with each entry, and refused with the index of each change that was not made and why.
update_type
ChatGPTChanges an item type. Only what you pass changes. childTypes replaces the child types you can see; a type with no child types listed allows any type under it. Changing the key changes how the type is named in the tools and the API, not its display ids.
update_view
ChatGPTChanges a saved view for everyone who sees it. Each setting you pass replaces that setting of one tab (named by tab, else the default tab) and the rest are kept; types and childTypes rescope every tab; title renames the view. Pass addTab instead of tab settings to add a tab. Name fields by their keys from describe_organization and values by their labels: option labels, emails or @me, team names, display ids, type keys. Built-in columns: title, type, displayId, dateCreated, dateUpdated, dependencies, wbs, predecessors, successors. A name that matches nothing is refused with what was not found. A view id is not an item: never pass one to the item tools.
update_view_access
ChatGPTChanges who can see a top-level view: everyone in the organization, or only the people and teams granted. A view in a folder shares the access of the top-level view it sits under. Restricting a view hides the view, not its items. get_view reads the audience and who is granted. A change that would leave you unable to see the view is refused.
add_automation
Claudeadd_dependency
Claudeadd_holidays
Claudeadd_team_members
Claudeadd_time_off
Claudeassign_role
Claudecreate_allocation
Claudecreate_field
Claudecreate_item
Claudecreate_rate
Claudecreate_team
Claudecreate_template
Claudecreate_type
Claudecreate_view
Claudedeactivate_people
Claudedelete_allocation
Claudedelete_attachment
Claudedelete_automation
Claudedelete_capacity
Claudedelete_field
Claudedelete_holidays
Claudedelete_item
Claudedelete_rate
Claudedelete_team
Claudedelete_template
Claudedelete_time_log
Claudedelete_time_off
Claudedelete_type
Claudedelete_view
Claudedescribe_organization
Claudeget_capacity
Claudeget_item
Claudeget_item_history
Claudeget_rates
Claudeget_timesheet
Claudeget_view
Claudeinvite_people
Claudelist_allocations
Claudelist_attachments
Claudelist_automations
Claudelist_holidays
Claudelist_invites
Claudelist_people
Claudelist_templates
Claudelist_time_logs
Claudelist_time_off
Claudelist_views
Claudelog_time
Clauderead_attachment
Clauderead_guide
Clauderemove_dependency
Clauderemove_team_members
Clauderename_attachment
Clauderevoke_invite
Claudesearch_help
Claudesearch_items
Claudeset_capacity
Claudeupdate_allocation
Claudeupdate_automation
Claudeupdate_capacity
Claudeupdate_field
Claudeupdate_holidays
Claudeupdate_item
Claudeupdate_rate
Claudeupdate_team
Claudeupdate_template
Claudeupdate_time_log
Claudeupdate_time_off
Claudeupdate_type
Claudeupdate_view
Claudeupdate_view_access
Claude