Stable release 1.2.2.
This reference is generated from the exact tool registry in
@teamgrid/mcp-server@1.2.2 and joined with the pinned API v1 capability
contract. It contains 208 business tools with explicit safety annotations. Unknown input properties are
rejected by every tool schema.
Use ChatGPT setup, safe writes and
resources and protocol support for complete workflows.
The catalog contains 84 reads
and 124 writes. Browse tools by business domain below; a domain heading is a catalog grouping, while Available in on each tool page is its exact profile membership.
Profiles at a glance
| Selected profile | Advertised tools | Adds beyond core |
|---|---|---|
core |
22 | Operational workspace, project, task, time-entry, list, tag, product, and product-group reads |
collaboration |
29 | Contacts, contact groups, call notes, and users |
governance |
28 | Custom-field definitions, services, and webhook configuration |
all |
36 | Preserved read-only union |
full |
208 | Complete inventory; explicit write opt-in |
| Workflow/domain profile | Total | Reads | Writes |
|---|---|---|---|
context |
34 | 34 | 0 |
work |
41 | 34 | 7 |
schedule-write |
24 | 15 | 9 |
content-write |
25 | 14 | 11 |
admin-write |
31 | 18 | 13 |
automation-write |
18 | 13 | 5 |
crm-write |
22 | 13 | 9 |
catalog-write |
45 | 21 | 24 |
integrations-write |
16 | 13 | 3 |
projects-write |
24 | 12 | 12 |
finance-write |
15 | 10 | 5 |
tasks-write |
43 | 16 | 27 |
time-write |
15 | 9 | 6 |
Select the narrowest profile your workflow needs. A profile controls which tools are advertised;
the API credential scopes and resource grants still control which data each advertised tool can
read or change. Hosted Production advertises full; these selectors configure local stdio.
Schedule tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_absence_archive |
Write | Archive an absence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | absences:write, workspace:read |
workspace-mutation |
teamgrid_absence_create |
Write | Create an absence. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | absences:write, workspace:read |
workspace-mutation |
teamgrid_absence_get |
Read | Get an absence | absences:read |
personal-data |
teamgrid_absence_restore |
Write | Restore an absence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | absences:write, workspace:read |
workspace-mutation |
teamgrid_absence_update |
Write | Update an absence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | absences:write, workspace:read |
workspace-mutation |
teamgrid_absences_list |
Read | List absences in a bounded interval | absences:read |
personal-data |
teamgrid_appointment_archive |
Write | Archive a TeamGrid-managed appointment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | appointments:write, workspace:read |
workspace-mutation |
teamgrid_appointment_create |
Write | Create a TeamGrid-managed appointment. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | appointments:write, workspace:read |
workspace-mutation |
teamgrid_appointment_get |
Read | Get an appointment | appointments:read |
personal-data |
teamgrid_appointment_restore |
Write | Restore a TeamGrid-managed appointment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | appointments:write, workspace:read |
workspace-mutation |
teamgrid_appointment_update |
Write | Update a TeamGrid-managed appointment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | appointments:write, workspace:read |
workspace-mutation |
teamgrid_appointments_list |
Read | List appointments in a bounded interval | appointments:read |
personal-data |
teamgrid_availability_list |
Read | List user availability | availability:read |
personal-data |
teamgrid_planned_work_list |
Read | List planned work in a bounded window | planned-work:read |
operational-data |
teamgrid_planned_work_operation_get |
Read | Get a planned-work replacement operation | planned-work:write |
operational-data |
teamgrid_task_planned_work_get |
Read | Get a task planned-work schedule | planned-work:read |
operational-data |
teamgrid_task_planned_work_replace |
Write | Replace task planned work asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | planned-work:write, workspace:read |
workspace-mutation |
Content tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_activity_list |
Read | List target activity | activity:read |
operational-data |
teamgrid_comment_archive |
Write | Archive a comment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. May notify other people. | comments:write, workspace:read, comments:read |
workspace-mutation |
teamgrid_comment_create |
Write | Create a target comment. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. May notify other people. | comments:write, workspace:read |
workspace-mutation |
teamgrid_comment_get |
Read | Get a comment May notify other people. | comments:read |
customer-content |
teamgrid_comment_restore |
Write | Restore a comment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. May notify other people. | comments:write, workspace:read, comments:read |
workspace-mutation |
teamgrid_comment_update |
Write | Edit a comment. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. May notify other people. | comments:write, workspace:read, comments:read |
workspace-mutation |
teamgrid_comments_list |
Read | List target comments May notify other people. | comments:read |
customer-content |
teamgrid_document_archive |
Write | Archive a document. Returns a compact mutation receipt without repeating document content. Read content through teamgrid_document_get.. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | documents:write, workspace:read |
workspace-mutation |
teamgrid_document_create |
Write | Create a document. Returns a compact mutation receipt without repeating document content. Read content through teamgrid_document_get.. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | documents:write, workspace:read |
workspace-mutation |
teamgrid_document_get |
Read | Get a document. Content is a bounded chunk, not necessarily the whole document. Continue with contentOffset=meta.contentPage.nextOffset and expectedRevision=meta.etag until nextOffset is null. Never infer omitted content or overwrite a document from an incomplete read. | documents:read |
customer-content |
teamgrid_document_restore |
Write | Restore a document. Returns a compact mutation receipt without repeating document content. Read content through teamgrid_document_get.. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | documents:write, workspace:read |
workspace-mutation |
teamgrid_document_update |
Write | Update a document. Returns a compact mutation receipt without repeating document content. Read content through teamgrid_document_get.. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | documents:write, workspace:read |
workspace-mutation |
teamgrid_documents_list |
Read | List document metadata | documents:read |
customer-content |
teamgrid_file_archive |
Write | Archive a file. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | files:write, workspace:read |
workspace-mutation |
teamgrid_file_get |
Read | Get file metadata | files:read |
customer-content |
teamgrid_file_rename |
Write | Rename a file. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | files:write, workspace:read |
workspace-mutation |
teamgrid_file_restore |
Write | Restore a file. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | files:write, workspace:read |
workspace-mutation |
teamgrid_files_list |
Read | List public-space file metadata | files:read |
customer-content |
Admin tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_audit_events_list |
Read | List developer audit events | audit:read |
governance-data |
teamgrid_export_create |
Write | Create an asynchronous export. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. Administrative action: review the exact target and access impact with the user. | exports:write, workspace:read |
workspace-mutation |
teamgrid_export_get |
Read | Get export job status | exports:read |
customer-content |
teamgrid_group_create |
Write | Create a workspace group. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. Administrative action: review the exact target and access impact with the user. | groups:write, workspace:read |
workspace-mutation |
teamgrid_group_delete |
Write | Delete a workspace group. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | groups:write, workspace:read |
workspace-mutation |
teamgrid_group_get |
Read | Get a workspace group | groups:read |
governance-data |
teamgrid_group_update |
Write | Update a workspace group. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | groups:write, workspace:read |
workspace-mutation |
teamgrid_groups_list |
Read | List workspace groups | groups:read |
operational-data |
teamgrid_invitation_cancel |
Write | Cancel a pending invitation. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. May notify other people. Administrative action: review the exact target and access impact with the user. | invitations:write, workspace:read |
workspace-mutation |
teamgrid_invitation_create |
Write | Invite a workspace member. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. May notify other people. Administrative action: review the exact target and access impact with the user. | invitations:write, workspace:read |
workspace-mutation |
teamgrid_invitation_get |
Read | Get a pending invitation May notify other people. | invitations:read |
governance-data |
teamgrid_invitation_resend |
Write | Resend a pending invitation. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. May notify other people. Administrative action: review the exact target and access impact with the user. | invitations:write, workspace:read |
workspace-mutation |
teamgrid_invitations_list |
Read | List pending invitations May notify other people. | invitations:read |
governance-data |
teamgrid_member_get |
Read | Get a workspace member | members:read |
personal-data |
teamgrid_member_remove |
Write | Remove a workspace member. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | members:write, workspace:read |
workspace-mutation |
teamgrid_member_role_update |
Write | Change a member role. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | members:write, workspace:read |
workspace-mutation |
teamgrid_members_list |
Read | List workspace members | members:read |
personal-data |
teamgrid_role_create |
Write | Create a workspace role. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. Administrative action: review the exact target and access impact with the user. | roles:write, workspace:read |
workspace-mutation |
teamgrid_role_delete |
Write | Delete a workspace role. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | roles:write, workspace:read |
workspace-mutation |
teamgrid_role_get |
Read | Get a workspace role | roles:read |
governance-data |
teamgrid_role_update |
Write | Update a workspace role. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | roles:write, workspace:read |
workspace-mutation |
teamgrid_roles_list |
Read | List workspace roles | roles:read |
governance-data |
teamgrid_workspace_settings_get |
Read | Get public workspace settings | workspace-settings:read |
governance-data |
teamgrid_workspace_settings_update |
Write | Update public workspace settings. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Administrative action: review the exact target and access impact with the user. | workspace-settings:write, workspace:read |
workspace-mutation |
Automation tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_automation_actions_list |
Read | List public automation actions | automations:read |
governance-data |
teamgrid_automation_definition_archive |
Write | Archive an automation definition. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | automations:write, workspace:read |
workspace-mutation |
teamgrid_automation_definition_create |
Write | Create an automation definition. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. Changes can affect future automated actions; inspect the definition and schedule first. | automations:write, workspace:read |
workspace-mutation |
teamgrid_automation_definition_get |
Read | Get an automation definition | automations:read |
governance-data |
teamgrid_automation_definition_restore |
Write | Restore an automation definition. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | automations:write, workspace:read |
workspace-mutation |
teamgrid_automation_definition_update |
Write | Update an automation definition. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | automations:write, workspace:read |
workspace-mutation |
teamgrid_automation_definition_versions_list |
Read | List immutable automation definition versions | automations:read |
governance-data |
teamgrid_automation_definitions_list |
Read | List automation definitions | automations:read |
governance-data |
teamgrid_automation_run_abort |
Write | Abort a running automation. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | automations:run, workspace:read |
workspace-mutation |
teamgrid_automation_run_get |
Read | Get an automation run | automations:read |
governance-data |
teamgrid_automation_runs_list |
Read | List automation runs | automations:read |
governance-data |
Crm tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_call_note_archive |
Write | Archive a call note. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | call-notes:write, workspace:read |
workspace-mutation |
teamgrid_call_note_create |
Write | Create a call note. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | call-notes:write, workspace:read |
workspace-mutation |
teamgrid_call_note_get |
Read | Get a call note | call-notes:read |
conversation-data |
teamgrid_call_note_restore |
Write | Restore an archived call note. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | call-notes:write, workspace:read |
workspace-mutation |
teamgrid_call_notes_list |
Read | List call notes | call-notes:read |
conversation-data |
teamgrid_contact_create |
Write | Create a contact. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | contacts:write, workspace:read |
workspace-mutation |
teamgrid_contact_get |
Read | Get a contact | contacts:read |
personal-data |
teamgrid_contact_group_archive |
Write | Archive a contact group. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | contact-groups:write, workspace:read |
workspace-mutation |
teamgrid_contact_group_create |
Write | Create a contact group. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | contact-groups:write, workspace:read |
workspace-mutation |
teamgrid_contact_group_get |
Read | Get a contact group | contact-groups:read |
governance-data |
teamgrid_contact_group_restore |
Write | Restore an archived contact group. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | contact-groups:write, workspace:read |
workspace-mutation |
teamgrid_contact_group_update |
Write | Update a contact group. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | contact-groups:write, workspace:read |
workspace-mutation |
teamgrid_contact_groups_list |
Read | List contact groups | contact-groups:read |
personal-data |
teamgrid_contact_update |
Write | Update a contact. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | contacts:write, workspace:read |
workspace-mutation |
teamgrid_contacts_list |
Read | List contacts | contacts:read |
personal-data |
Catalog tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_custom_field_definition_archive |
Write | Archive a custom-field definition. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | custom-field-definitions:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_definition_create |
Write | Create a custom-field definition. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | custom-field-definitions:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_definition_get |
Read | Get a custom-field definition | custom-field-definitions:read |
governance-metadata |
teamgrid_custom_field_definition_restore |
Write | Restore an archived custom-field definition. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | custom-field-definitions:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_definition_update |
Write | Update a custom-field definition. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | custom-field-definitions:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_definitions_list |
Read | List custom-field definitions | custom-field-definitions:read |
governance-metadata |
teamgrid_custom_field_value_clear |
Write | Clear a custom-field value. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | custom-field-values:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_value_get |
Read | Get a custom-field value | custom-field-values:read |
operational-data |
teamgrid_custom_field_value_set |
Write | Set a custom-field value. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | custom-field-values:write, workspace:read |
workspace-mutation |
teamgrid_custom_field_values_get |
Read | Read custom-field values for one resource | custom-field-values:read |
operational-data |
teamgrid_list_archive |
Write | Archive a list. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | lists:write, workspace:read |
workspace-mutation |
teamgrid_list_create |
Write | Create a list. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | lists:write, workspace:read |
workspace-mutation |
teamgrid_list_get |
Read | Get a list | lists:read |
operational-data |
teamgrid_list_restore |
Write | Restore an archived list. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | lists:write, workspace:read |
workspace-mutation |
teamgrid_list_update |
Write | Update a list. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | lists:write, workspace:read |
workspace-mutation |
teamgrid_lists_list |
Read | List workspace lists | lists:read |
operational-data |
teamgrid_product_archive |
Write | Archive a product. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | products:write, workspace:read |
workspace-mutation |
teamgrid_product_create |
Write | Create a product. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | products:write, workspace:read |
workspace-mutation |
teamgrid_product_get |
Read | Get a product | products:read |
operational-data |
teamgrid_product_group_archive |
Write | Archive a product group. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | product-groups:write, workspace:read |
workspace-mutation |
teamgrid_product_group_create |
Write | Create a product group. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | product-groups:write, workspace:read |
workspace-mutation |
teamgrid_product_group_get |
Read | Get a product group | product-groups:read |
governance-data |
teamgrid_product_group_update |
Write | Update a product group. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | product-groups:write, workspace:read |
workspace-mutation |
teamgrid_product_groups_list |
Read | List product groups | product-groups:read |
operational-data |
teamgrid_product_update |
Write | Update a product. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | products:write, workspace:read |
workspace-mutation |
teamgrid_products_list |
Read | List products | products:read |
operational-data |
teamgrid_service_archive |
Write | Archive a service. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | services:write, workspace:read |
workspace-mutation |
teamgrid_service_create |
Write | Create a service. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | services:write, workspace:read |
workspace-mutation |
teamgrid_service_get |
Read | Get a service | services:read |
commercial-data |
teamgrid_service_restore |
Write | Restore an archived service. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | services:write, workspace:read |
workspace-mutation |
teamgrid_service_update |
Write | Update a service. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | services:write, workspace:read |
workspace-mutation |
teamgrid_services_list |
Read | List services | services:read |
commercial-data |
teamgrid_tag_archive |
Write | Archive a tag. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | tags:write, workspace:read |
workspace-mutation |
teamgrid_tag_create |
Write | Create a tag. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | tags:write, workspace:read |
workspace-mutation |
teamgrid_tag_get |
Read | Get a tag | tags:read |
operational-data |
teamgrid_tag_restore |
Write | Restore an archived tag. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | tags:write, workspace:read |
workspace-mutation |
teamgrid_tag_update |
Write | Update a tag. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | tags:write, workspace:read |
workspace-mutation |
teamgrid_tags_list |
Read | List tags | tags:read |
operational-data |
Integrations tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_event_catalog_get |
Read | Get the scoped public event catalog | events:read |
operational-data |
teamgrid_integration_installations_list |
Read | List integration installation status | integrations:read |
governance-data |
teamgrid_webhook_deliveries_list |
Read | List webhook delivery history | webhooks:read |
security-configuration |
teamgrid_webhook_delivery_get |
Read | Get webhook delivery metadata | webhooks:read |
security-configuration |
teamgrid_webhook_delivery_test |
Write | Send a signed test webhook delivery. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | webhooks:write, workspace:read |
workspace-mutation |
teamgrid_webhook_get |
Read | Get a webhook | webhooks:read |
security-configuration |
teamgrid_webhook_remove |
Write | Remove a webhook. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | webhooks:write, workspace:read |
workspace-mutation |
teamgrid_webhook_update |
Write | Update or reactivate a webhook. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | webhooks:write, workspace:read |
workspace-mutation |
teamgrid_webhooks_list |
Read | List webhooks | webhooks:read |
security-configuration |
Projects tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_project_archive |
Write | Archive a project asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | projects:lifecycle, workspace:read |
workspace-mutation |
teamgrid_project_complete |
Write | Complete a project asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | projects:lifecycle, workspace:read |
workspace-mutation |
teamgrid_project_create |
Write | Create a project. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | projects:write, workspace:read |
workspace-mutation |
teamgrid_project_get |
Read | Get a project | projects:read |
operational-data |
teamgrid_project_lifecycle_operation_get |
Read | Get a project lifecycle operation | projects:lifecycle |
operational-data |
teamgrid_project_reopen |
Write | Reopen a project asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | projects:lifecycle, workspace:read |
workspace-mutation |
teamgrid_project_restore |
Write | Restore a project asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | projects:lifecycle, workspace:read |
workspace-mutation |
teamgrid_project_sharing_get |
Read | Get project sharing | projects:sharing |
operational-data |
teamgrid_project_sharing_replace |
Write | Replace project sharing. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Administrative action: review the exact target and access impact with the user. | projects:sharing, workspace:read |
workspace-mutation |
teamgrid_project_template_archive |
Write | Archive a project template. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | project-templates:write, workspace:read |
workspace-mutation |
teamgrid_project_template_create |
Write | Capture a project as a template. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | project-templates:write, workspace:read |
workspace-mutation |
teamgrid_project_template_get |
Read | Get project-template metadata | project-templates:read |
operational-data |
teamgrid_project_template_instantiate |
Write | Instantiate a project template asynchronously. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | project-templates:write, projects:write, workspace:read |
workspace-mutation |
teamgrid_project_template_instantiation_get |
Read | Get a project-template instantiation operation | project-templates:write, projects:write |
operational-data |
teamgrid_project_template_restore |
Write | Restore an archived project template. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | project-templates:write, workspace:read |
workspace-mutation |
teamgrid_project_template_update |
Write | Update project-template metadata. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | project-templates:write, workspace:read |
workspace-mutation |
teamgrid_project_templates_list |
Read | List project templates | project-templates:read |
operational-data |
teamgrid_project_update |
Write | Update a project. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | projects:write, workspace:read |
workspace-mutation |
teamgrid_projects_list |
Read | List projects | projects:read |
operational-data |
Finance tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_project_statement_archive |
Write | Archive a project statement. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | project-statements:write, workspace:read |
workspace-mutation |
teamgrid_project_statement_create |
Write | Create a project statement. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | project-statements:write, workspace:read |
workspace-mutation |
teamgrid_project_statement_get |
Read | Get a project statement | project-statements:read |
commercial-data |
teamgrid_project_statement_restore |
Write | Restore a project statement. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | project-statements:write, workspace:read |
workspace-mutation |
teamgrid_project_statement_update |
Write | Update a project statement. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | project-statements:write, workspace:read |
workspace-mutation |
teamgrid_project_statements_list |
Read | List project statements | project-statements:read |
commercial-data |
teamgrid_time_entry_billing_get |
Read | Get time-entry billing state | time-entries:billing |
commercial-data |
teamgrid_time_entry_billing_update |
Write | Update time-entry billing state. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | time-entries:billing, workspace:read |
workspace-mutation |
Workspace context
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_search |
Read | Search authorized TeamGrid resources | search:read |
cross-domain-sensitive |
teamgrid_users_list |
Read | List workspace users | users:read |
personal-data |
teamgrid_workspace_get |
Read | Get the authenticated workspace | workspace:read |
tenant-metadata |
Tasks tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_task_archive |
Write | Archive a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_complete |
Write | Complete a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_create |
Write | Create a task. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_duplicate |
Write | Duplicate a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Reuse the same idempotencyKey and payload for the same intent. | tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_get |
Read | Get a task | tasks:read |
operational-data |
teamgrid_task_move |
Write | Move or reorder a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_apply_task_template |
Write | Replace a recurrence template from a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_archive |
Write | Archive a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_create |
Write | Create a task recurrence. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_end |
Write | End a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_event_submit |
Write | Submit an event to a task recurrence. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. Changes can affect future automated actions; inspect the definition and schedule first. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | task-recurrences:run, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_get |
Read | Get a task recurrence | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_occurrence_get |
Read | Get a task recurrence occurrence | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_occurrence_override |
Write | Override a task recurrence occurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_occurrence_override_clear |
Write | Clear a task recurrence occurrence override. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_occurrence_retry |
Write | Retry a failed task recurrence occurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_occurrences_list |
Read | List task recurrence occurrences | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_operation_cancel |
Write | Cancel a task recurrence operation. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_operation_get |
Read | Get a task recurrence operation | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_owner_transfer |
Write | Transfer task recurrence ownership. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_pause |
Write | Pause a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_preview |
Read | Preview a stored task recurrence | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_preview_input |
Read | Preview a draft task recurrence Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | task-recurrences:write, tasks:read, tasks:write |
operational-data |
teamgrid_task_recurrence_recheck |
Write | Recheck a task recurrence asynchronously. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. Changes can affect future automated actions; inspect the definition and schedule first. Acceptance is not completion. Use the corresponding operation-get tool to inspect the returned operation until terminal. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_remove_from_tasks |
Write | Remove a task recurrence from its tasks. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_restore |
Write | Restore a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_resume |
Write | Resume a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_update |
Write | Update a task recurrence. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_version_get |
Read | Get a task recurrence version | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrence_version_restore |
Write | Restore a task recurrence version. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. Changes can affect future automated actions; inspect the definition and schedule first. | task-recurrences:write, tasks:read, tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_recurrence_versions_list |
Read | List task recurrence versions | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_recurrences_list |
Read | List task recurrences | task-recurrences:read, tasks:read |
operational-data |
teamgrid_task_reopen |
Write | Reopen a completed task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_restore |
Write | Restore an archived task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_subtasks_replace |
Write | Replace a task checklist. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_task_update |
Write | Update a task. Changes the selected workspace under current API permissions. Read the target first; submit its exact ETag. On conflict, review the current state before making a new decision. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_tasks_bulk_update |
Write | Update multiple tasks safely. Changes the selected workspace under current API permissions. Each item requires the developerRevision from its reviewed task. Results are independent: inspect every item for success, conflict or failure. Never refresh revisions and retry the entire batch automatically. | tasks:write, workspace:read |
workspace-mutation |
teamgrid_tasks_list |
Read | List tasks | tasks:read |
operational-data |
Time tools
| Tool | Access | Purpose | Required scopes (all) | Data classification |
|---|---|---|---|---|
teamgrid_task_timer_start |
Write | Start task time tracking. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | tasks:write, time-entries:write, workspace:read |
workspace-mutation |
teamgrid_task_timer_stop |
Write | Stop task time tracking. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | tasks:write, time-entries:write, workspace:read |
workspace-mutation |
teamgrid_time_entries_list |
Read | List time entries | time-entries:read |
work-record-data |
teamgrid_time_entry_archive |
Write | Archive a time entry. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | time-entries:write, workspace:read |
workspace-mutation |
teamgrid_time_entry_create |
Write | Create a time entry. Changes the selected workspace under current API permissions. Reuse the same idempotencyKey and payload for the same intent. | time-entries:write, workspace:read |
workspace-mutation |
teamgrid_time_entry_get |
Read | Get a time entry | time-entries:read |
work-record-data |
teamgrid_time_entry_restore |
Write | Restore an archived time entry. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | time-entries:write, workspace:read |
workspace-mutation |
teamgrid_time_entry_update |
Write | Update a time entry. Changes the selected workspace under current API permissions. The API has no conditional-write or replay contract for this action. Do not retry an uncertain result automatically; read the current state first. | time-entries:write, workspace:read |
workspace-mutation |
Shared result contract
Every successful value is returned twice: as MCP structured content and as the same serialized JSON
in a text content block. Results are capped at 256 KiB. Large reads use bounded pages or document sections. Mutations use small receipts;
accepted, partial and uncertain outcomes must not be mistaken for completed writes. API and SDK failures preserve safe machine-readable codes and available status, request ID, and
retry metadata, with developer secrets redacted. Unknown failures use teamgrid_request_failed.
List tools use opaque cursor pagination. Pass meta.page.nextCursor back as cursor; never
construct or decode a cursor. The federated search tool is bounded to 50 results and is not
cursor-paginated.
Continue with the first MCP query, configuration, or MCP troubleshooting.