MCP tool directory

66 workspace tools

34 native tools ship in tools/list. The rest live in the catalog — discover with search_tools, then execute_tool. Every call is tenant-scoped, permission-checked, and metered.

Catalog synced 2026-07-12

Showing 66 of 66 tools

Chat 1

search_messagesnative

Search chat messages

Search chat messages in a project, limited to channels you are a member of. Optionally scope to one channel.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, query, channelId, limit
  • projectId
  • query
  • channelId
  • limit

Core 6

apply_pending_actionnative

Apply a confirmed action

Execute a previously previewed destructive action using its confirmation token. Destructive tools (bulk updates, deletions) return a preview and a token — pass that token here to apply the action.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
No parameters
execute_toolnative

Execute a catalog tool

Run a tool discovered via search_tools, by name, with its arguments. Permissions and rate limits apply exactly as if the tool were called directly.

Write level
Read
OAuth scopes
mcp:read
Parameters
tool, arguments
  • tool
  • arguments
get_recent_activitynative

Get Recent Activity

Cross-module feed of recent activity across the workspace: task updates, chat messages, document edits, and meeting notes from the last N hours. Useful for daily standup summaries.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
search_toolsnative

Search tool catalog

Search the Gealo tool catalog by keyword or intent (e.g. "blockers", "sprint review", "leave balance"). Returns matching tool names, descriptions, and input hints; run them with execute_tool. Only tools you are permitted to use are returned.

Write level
Read
OAuth scopes
mcp:read
Parameters
query
  • query
summarize_workspacenative

Summarize Workspace

Cross-module summary of the current workspace: project count, open task count, recent chat activity, upcoming meetings, and document count. Use for orientation at session start after whoami.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
whoaminative

Who am I

Identity grounding: the authenticated user, workspace (tenant), role, plan tier, enabled capabilities, and remaining monthly MCP tool-call budget. Call this first in a session.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters

Dashboard 2

my_worknative

My work

The current user's work snapshot across all their projects: open/due-today/overdue counts and the top assigned tasks. Good session-opening call after whoami.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
summarize_projectnative

Summarize project

Structured project digest: metadata, task status breakdown, and meetings in the next 7 days. Returns data for you to synthesize — richer than get_project_overview.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId

Documents 1

search_documentsnative

Search documents

Search files in a project by name. Returns metadata (name, size, uploader, date) — no download links.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, query, limit
  • projectId
  • query
  • limit

Meetings 4

extract_action_itemscatalog

Extract action items

Retrieve a meeting's notes and attendee list for action-item extraction. Extract owners/tasks/dates from the returned (untrusted-wrapped) content.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
get_meetingnative

Get meeting details

Details of one meeting: time, attendees, agenda, and notes. Requires meeting view access in the project.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, meetingId
  • projectId
  • meetingId
list_meetingsnative

List meetings

List meetings in a project within a date window (defaults to the next 14 days). Returns IDs, titles, and times.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, from, to
  • projectId
  • from
  • to
summarize_meetingcatalog

Summarize meeting

Retrieve a meeting's agenda and notes for summarization. Returns the raw (untrusted-wrapped) content plus metadata; produce the summary from it.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters

Notifications 4

get_unread_notification_countnative

Get unread notification count

Count of unread notifications for the current user in this workspace.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
list_notificationsnative

List notifications

Paginated in-app notifications for the current user in this workspace. Self-scoped — cannot read another user's notifications.

Write level
Read
OAuth scopes
mcp:read
Parameters
cursor, limit
  • cursor
  • limit
mark_all_notifications_readnative

Mark all notifications read

Mark every unread notification as read for the current user in this workspace.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
No parameters
mark_notification_readnative

Mark notification read

Mark one notification as read for the current user in this workspace.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
notificationId
  • notificationId

Operations 2

my_leave_balancecatalog

My leave balance

The current user's own leave balance (paid/unpaid allowed, used, remaining). Self-scoped — cannot look up other members.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters
Entitlement
hrModule
workspace_healthcatalog

Workspace health

Snapshot of the tenant's plan posture: tier, enabled capabilities, and headline caps. No per-user data.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters

Projects 27

archive_projectnative

Archive project

Soft-delete (archive) a project. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_DELETE_PROJECT on the project.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId
  • projectId
compare_releasescatalog

Compare releases

Compare two releases of a project: task progress and linked-task counts side by side.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, releaseA, releaseB
  • projectId
  • releaseA
  • releaseB
complete_sprintcatalog

Complete sprint

Complete an active sprint, optionally rolling unfinished tasks over to another sprint (or back to the backlog when rolloverToSprintId is omitted). Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_EDIT_SPRINTS permission.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, sprintId
  • projectId
  • sprintId
create_custom_fieldcatalog

Create custom field

Add a custom field definition to a project. The field key is generated and returned — use it in customFieldValues on create_task / update_task. Requires CAN_ACCESS_CUSTOM_FIELD_SETTINGS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, name, required
  • projectId
  • name
  • required
create_releasecatalog

Create release

Create a release in a project. Requires CAN_CREATE_RELEASES permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, name, description
  • projectId
  • name
  • description
create_sprintcatalog

Create sprint

Create a sprint in a project (starts in "planning"; use start_sprint to activate). Requires CAN_CREATE_SPRINTS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, name, goal
  • projectId
  • name
  • goal
create_task_statuscatalog

Create task status

Add a new status column to a project's task workflow. Requires CAN_CREATE_TASK_STATUS permission; only the project owner may change the workflow.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, name, color
  • projectId
  • name
  • color
delete_custom_fieldcatalog

Delete custom field

Remove a custom field definition from a project. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Values already stored on tasks are orphaned (no longer rendered). Requires CAN_ACCESS_CUSTOM_FIELD_SETTINGS permission.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, fieldKey
  • projectId
  • fieldKey
delete_releasecatalog

Delete release

Delete a release (task links are removed; tasks are kept). Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_DELETE_RELEASES permission.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, releaseId
  • projectId
  • releaseId
delete_sprintcatalog

Delete sprint

Delete a sprint. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_DELETE_SPRINTS permission.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, sprintId
  • projectId
  • sprintId
delete_task_statuscatalog

Delete task status

Remove a status from a project's workflow. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Tasks currently in the status keep their statusKey and must be moved manually. Requires CAN_DELETE_TASK_STATUS permission; owner-only. Default statuses cannot be removed.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, statusKey
  • projectId
  • statusKey
find_blockerscatalog

Find blockers

Identify likely blockers in a project: overdue tasks and high/critical-priority tasks that are not done.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId
get_project_overviewnative

Project overview

Status digest for one project: metadata plus task counts by status. Requires access to the project.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId
get_releasecatalog

Get release details

Details of one release: status, target date, task progress, and linked tasks.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, releaseId
  • projectId
  • releaseId
get_sprintcatalog

Get sprint details

Details of one sprint: status, dates, goal, and completion summary when available.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, sprintId
  • projectId
  • sprintId
list_custom_fieldscatalog

List custom fields

List the custom field definitions of a project: key, name, type, required flag, and select options. Field keys are what create_task / update_task accept in customFieldValues.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId
list_projectsnative

List projects

List the projects (workspaces) the current user can access in this tenant, with IDs and names. Paginated via cursor.

Write level
Read
OAuth scopes
mcp:read
Parameters
cursor
  • cursor
list_releasescatalog

List releases

List the releases of a project: name, status (planned/in_progress/released/archived), and target date. Release IDs feed get_release, compare_releases, and set_task_releases.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, includeArchived
  • projectId
  • includeArchived
list_sprintscatalog

List sprints

List the sprints of a project: name, status (planning/active/completed/cancelled), dates, and goal. Sprint IDs feed get_sprint and update_task (sprintId).

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId
list_task_statusescatalog

List task statuses

List the task status workflow of a project in board order: key, name, type (start/progress/end), and default/archived flags. Status keys are what create_task and update_task accept as statusKey.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId
  • projectId
reorder_task_statusescatalog

Reorder task statuses

Set the board order of a project's task statuses. Pass every existing status key exactly once, in the desired order. Requires CAN_EDIT_TASK_STATUS permission; owner-only.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId
  • projectId
review_sprintcatalog

Review recent sprint

Sprint-style review of a project over a recent window (default 14 days): what got done, what is in flight, what has not started.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, days
  • projectId
  • days
start_sprintcatalog

Start sprint

Move a sprint from planning to active. Requires CAN_EDIT_SPRINTS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, sprintId
  • projectId
  • sprintId
update_custom_fieldcatalog

Update custom field

Edit a custom field definition: rename, change type, toggle required, or replace select options. Requires CAN_ACCESS_CUSTOM_FIELD_SETTINGS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, fieldKey, name, required, options
  • projectId
  • fieldKey
  • name
  • required
  • options
update_releasecatalog

Update release

Edit a release: name, description, status (moving to "released" stamps releasedAt), target date, or notes markdown. Requires CAN_EDIT_RELEASES permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, releaseId, name, description
  • projectId
  • releaseId
  • name
  • description
update_sprintcatalog

Update sprint

Edit sprint name, goal, or dates. Lifecycle transitions go through start_sprint / complete_sprint instead. Requires CAN_EDIT_SPRINTS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, sprintId, name, goal
  • projectId
  • sprintId
  • name
  • goal
update_task_statuscatalog

Update task status definition

Edit a status definition in a project's workflow: rename, recolor, or change its stage type. This edits the workflow itself — to move a task to a different status, use update_task with statusKey. Requires CAN_EDIT_TASK_STATUS permission; owner-only.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, statusKey, name, color
  • projectId
  • statusKey
  • name
  • color

Search 3

answer_from_workspacecatalog

Answer from workspace

Retrieve cited evidence from across the workspace (tasks, documents, meetings) for a question. Returns sources with snippets; synthesize the answer from them and cite the IDs.

Write level
Read
OAuth scopes
mcp:read
Parameters
question, limit
  • question
  • limit

Tasks 15

add_commentnative

Add task comment

Add a comment to a task. Requires CAN_CREATE_TASK_COMMENTS permission on the task's project.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, content
  • taskId
  • content
add_task_commentnative

Add task comment

Add a comment to a task. Requires CAN_CREATE_TASK_COMMENTS on the task's project.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, content
  • taskId
  • content
add_task_dependencynative

Add task dependency

Add a dependency: the blocking task must complete before this task can proceed. Requires CAN_EDIT_TASKS on the project.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, blockedByTaskId
  • taskId
  • blockedByTaskId
assign_tasknative

Assign task

Assign or reassign a task to a user. Pass assigneeId to assign, or null to unassign. Requires CAN_EDIT_TASKS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId
  • taskId
bulk_update_task_statusnative

Bulk update task status

Move multiple tasks to a target status in one operation. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_EDIT_TASKS on the project.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, targetStatus
  • projectId
  • targetStatus
create_tasknative

Create task

Create a new task in a project. Requires write access and CAN_CREATE_TASKS permission on the project.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
projectId, title, description, statusKey, priority, dueDate, type, sprintId
  • projectId
  • title
  • description
  • statusKey
  • priority
  • dueDate
  • type
  • sprintId
delete_task_commentnative

Delete task comment

Delete a comment from a task. Requires confirmation: the first call returns a preview and token; call apply_pending_action with the token to execute. Requires CAN_DELETE_TASK_COMMENTS on the project.

Write level
Destructive
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, commentId
  • taskId
  • commentId
get_tasknative

Get task details

Full details of one task by its ID: status, assignees, description, parent, and release. Requires view access to the task’s project.

Write level
Read
OAuth scopes
mcp:read
Parameters
taskId
  • taskId
list_task_commentsnative

List task comments

Paginated comments on a task. Requires CAN_VIEW_TASK_COMMENTS on the task's project.

Write level
Read
OAuth scopes
mcp:read
Parameters
taskId, page, limit, sort
  • taskId
  • page
  • limit
  • sort
list_task_dependenciesnative

List task dependencies

List tasks this task blocks and tasks blocking it. Requires CAN_VIEW_TASKS on the task's project.

Write level
Read
OAuth scopes
mcp:read
Parameters
taskId
  • taskId
remove_task_dependencynative

Remove task dependency

Remove a dependency link by its ID (from list_task_dependencies). Requires CAN_EDIT_TASKS on the project of the dependent task.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, dependencyId
  • taskId
  • dependencyId
search_tasksnative

Search tasks

Search tasks in a project by title or ticket number (e.g. "TASK-123", "login bug"). Returns compact ID-annotated summaries.

Write level
Read
OAuth scopes
mcp:read
Parameters
projectId, query
  • projectId
  • query
set_task_releasescatalog

Set task releases

Set the fix versions of a task: replaces the task's release links with the given release IDs (pass an empty array to unlink all). Releases must belong to the task's project. Requires CAN_EDIT_TASKS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId
  • taskId
update_tasknative

Update task

Update fields on an existing task: title, description, status, priority, due date, type, sprint assignment, or custom field values. Requires CAN_EDIT_TASKS permission.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, title, description, statusKey, priority, dueDate, type
  • taskId
  • title
  • description
  • statusKey
  • priority
  • dueDate
  • type
update_task_commentnative

Update task comment

Edit a comment on a task. Only the comment author may edit. Requires CAN_EDIT_TASK_COMMENTS on the project.

Write level
Write
OAuth scopes
mcp:read, mcp:write
Parameters
taskId, commentId, content
  • taskId
  • commentId
  • content

usage 1

usage_reportcatalog

MCP usage report

Tenant-level MCP consumption this month vs the plan budget. Requires usage-viewing permission.

Write level
Read
OAuth scopes
mcp:read
Parameters
No parameters