parabol_add_comment

MUTATES Parabol data: add a comment to a meeting discussion thread. Required: content (stringified TipTap/ProseMirror JSON document), discussionId, threadSortOrder (Int). Optionally isAnonymous or threadParentId (to reply). Parabol GraphQL: addComment(comment) → union. Requires COMMENTS_WRITE.

destructive

Argument	Type	Description
fields	object	Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).
content*	string	Comment body as a stringified TipTap/ProseMirror JSON document (required).
isAnonymous	boolean	Post the comment anonymously.
discussionId*	string	The discussion (meeting thread) id (required).
threadParentId	string	Parent comment id, to post a threaded reply.
threadSortOrder	integer	Position within the thread (Int). Defaults to 0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "content",
    "discussionId"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "content": {
      "type": "string",
      "description": "Comment body as a stringified TipTap/ProseMirror JSON document (required)."
    },
    "isAnonymous": {
      "type": "boolean",
      "description": "Post the comment anonymously."
    },
    "discussionId": {
      "type": "string",
      "description": "The discussion (meeting thread) id (required)."
    },
    "threadParentId": {
      "type": "string",
      "description": "Parent comment id, to post a threaded reply."
    },
    "threadSortOrder": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Position within the thread (Int). Defaults to 0."
    }
  }
}

parabol_create_reflection

MUTATES Parabol data: add a reflection card to a running retrospective's reflect phase. Required: meetingId, promptId (the reflect-prompt/column), sortOrder (Float). `content` (optional) is a stringified TipTap/ProseMirror JSON document (<=2000 chars). Parabol GraphQL: createReflection(input). Requires MEETINGS_WRITE.

destructive

Argument	Type	Description
fields	object	Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).
content	string	Reflection text as a stringified TipTap/ProseMirror JSON document.
promptId*	string	The reflect-prompt (column) id (required).
meetingId*	string	The retrospective meeting id (required).
sortOrder	number	Sort order within the column (Float). Defaults to 0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "meetingId",
    "promptId"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "content": {
      "type": "string",
      "description": "Reflection text as a stringified TipTap/ProseMirror JSON document."
    },
    "promptId": {
      "type": "string",
      "description": "The reflect-prompt (column) id (required)."
    },
    "meetingId": {
      "type": "string",
      "description": "The retrospective meeting id (required)."
    },
    "sortOrder": {
      "type": "number",
      "description": "Sort order within the column (Float). Defaults to 0."
    }
  }
}

parabol_create_task

MUTATES Parabol data: create a task on a team. Required: teamId and status (active|stuck|done|future). Provide `plaintextContent` for the task text (and/or `content`, which is a stringified TipTap/ProseMirror JSON document). Optionally assign to a userId or link to a meetingId/discussionId. Parabol GraphQL: createTask(newTask, area). Requires TASKS_WRITE.

destructive

Argument	Type	Description
area	string	Optional AreaEnum context for the task (e.g. 'teamDash', 'meeting').
fields	object	Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).
status	string	Task status (TaskStatusEnum). Defaults to 'active'.
teamId*	string	The team id to create the task on (required).
userId	string	Assign the task to this user id.
content	string	Rich-text content as a stringified TipTap/ProseMirror JSON document.
meetingId	string	Link the task to this meeting id.
sortOrder	number

parabol_get_meeting

Fetch one meeting by id with its phases and stages. For a retrospective it also returns the reflection groups and reflections plus vote/topic/task/comment counts. Uses __typename so you can tell meeting types apart. Parabol GraphQL: viewer.meeting(meetingId). Requires MEETINGS_READ.

read-only

Argument	Type	Description
meetingId*	string	The meeting id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "meetingId"
  ],
  "properties": {
    "meetingId": {
      "type": "string",
      "description": "The meeting id."
    }
  }
}

parabol_get_organization

Fetch one organization by id, including its teams. Parabol GraphQL: viewer.organization(orgId). Requires ORGS_READ (+ TEAMS_READ for teams).

read-only

Argument	Type	Description
orgId*	string	The organization id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "orgId"
  ],
  "properties": {
    "orgId": {
      "type": "string",
      "description": "The organization id."
    }
  }
}

parabol_get_team

Fetch one team by id: metadata, its team members (with each member's user), active meetings, and organization. Parabol GraphQL: viewer.team(teamId). Requires TEAMS_READ (+ MEETINGS_READ for activeMeetings, ORGS_READ for organization).

read-only

Argument	Type	Description
teamId*	string	The team id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "The team id."
    }
  }
}

parabol_get_viewer

Fetch the authenticated Parabol user (the token owner): id, preferredName, email, tier, and the team ids (tms) they belong to. Parabol GraphQL: query { viewer { ... } }. Requires the USERS_READ scope. Start here to discover your identity and team ids.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

parabol_graphql

MUTATES Parabol data (potentially): escape hatch to run an arbitrary Parabol GraphQL operation — including any mutation — against action.parabol.co/graphql with optional variables. Use for operations not covered by the curated tools. Your token must carry the scope the operation requires. Prefer parabol_query for read-only calls.

destructive

Argument	Type	Description
query*	string	A GraphQL query or mutation document.
variables	object	Variables object for the operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "A GraphQL query or mutation document."
    },
    "variables": {
      "type": "object",
      "description": "Variables object for the operation.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

parabol_invite_to_team

MUTATES Parabol data: send team invitations by email. Required: teamId and invitees (an array of email addresses). Optionally scope to a meetingId. Parabol GraphQL: inviteToTeam(teamId, invitees). Requires TEAMS_WRITE.

destructive

Argument	Type	Description
teamId*	string	The team id to invite into (required).
invitees*	array	Email addresses to invite (required).
meetingId	string	Optionally associate the invitation with a meeting id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId",
    "invitees"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "The team id to invite into (required)."
    },
    "invitees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Email addresses to invite (required)."
    },
    "meetingId": {
      "type": "string",
      "description": "Optionally associate the invitation with a meeting id."
    }
  }
}

parabol_list_active_meetings

List a team's currently-active (in-progress) meetings. Parabol GraphQL: viewer.team(teamId).activeMeetings. Requires TEAMS_READ + MEETINGS_READ.

read-only

Argument	Type	Description
teamId*	string	The team id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "The team id."
    }
  }
}

parabol_list_meetings

List past/ongoing meetings for one or more teams (Relay connection), newest first. `teamIds` is required. `meetingTypes` defaults to all four (retrospective, action, poker, teamPrompt). `before` bounds the window (defaults to now); paginate older with `after`. Parabol GraphQL: viewer.meetings. Requires MEETINGS_READ.

read-only

Argument	Type	Description
after	string	DateTime cursor — return meetings before this ISO timestamp (older page).
first	integer	Max meetings to return (default 20).
before	string	DateTime upper bound (ISO). Defaults to now.
teamIds*	array	Team ids to fetch meetings for (required).
meetingTypes	array	Meeting types to include (MeetingTypeEnum). Defaults to all four.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamIds"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "DateTime cursor — return meetings before this ISO timestamp (older page)."
    },
    "first": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max meetings to return (default 20)."
    },
    "before": {
      "type": "string",
      "description": "DateTime upper bound (ISO). Defaults to now."
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Team ids to fetch meetings for (required)."
    },
    "meetingTypes": {
      "type": "array",
      "items": {
        "enum": [
          "retrospective",
          "action",
          "poker",
          "teamPrompt"
        ],
        "type": "string"
      },
      "description": "Meeting types to include (MeetingTypeEnum). Defaults to all four."
    }
  }
}

parabol_list_organization_users

List the users in an organization (Relay connection): each org-user's role, joinedAt, tier, and underlying user (preferredName, email). Paginate with `first` + `after` (pass the last edge's `cursor`). Parabol GraphQL: viewer.organization(orgId).organizationUsers. Requires ORGS_READ + USERS_READ.

read-only

Argument	Type	Description
after	string	Cursor for the next page (the `cursor` of the last edge from a prior call).
first	integer	Max org-users to return (page size).
orgId*	string	The organization id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "orgId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Cursor for the next page (the `cursor` of the last edge from a prior call)."
    },
    "first": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Max org-users to return (page size)."
    },
    "orgId": {
      "type": "string",
      "description": "The organization id."
    }
  }
}

parabol_list_organizations

List the organizations the viewer belongs to: id, name, tier, billingTier. Parabol GraphQL: viewer.organizations. Requires ORGS_READ.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

parabol_list_tasks

List the viewer's tasks (Relay connection), optionally filtered by team, user, status, archived state, or a text query. Paginate with `first` + the `after` DateTime cursor. Parabol GraphQL: viewer.tasks. Requires TASKS_READ.

read-only

Argument	Type	Description
after	string	DateTime cursor for the next (older) page (the last edge's cursor).
first	integer	Max tasks to return (default 20).
teamIds	array	Filter to these team ids.
userIds	array	Filter to tasks assigned to these user ids.
archived	boolean	Include archived tasks (default false).
filterQuery	string	Free-text filter on task content.
statusFilters	array	Filter by task status (TaskStatusEnum: active, stuck, done, future).
includeUnassigned	boolean	Include unassigned tasks (default false).

Input schema (JSON)

parabol_list_team_members

List the members of a team, each with role flags (isLead, isOrgAdmin) and the underlying user (preferredName, email). Parabol GraphQL: viewer.team(teamId).teamMembers. Requires TEAMS_READ.

read-only

Argument	Type	Description
sortBy	string	Optional field to sort members by (e.g. 'preferredName').
teamId*	string	The team id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "sortBy": {
      "type": "string",
      "description": "Optional field to sort members by (e.g. 'preferredName')."
    },
    "teamId": {
      "type": "string",
      "description": "The team id."
    }
  }
}

parabol_list_teams

List the teams the viewer belongs to, with each team's id, name, orgId, tier, and team lead. Parabol GraphQL: viewer.teams. Requires the TEAMS_READ scope.

read-only

Argument	Type	Description
includeArchived	boolean	Include archived teams (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "includeArchived": {
      "type": "boolean",
      "description": "Include archived teams (default false)."
    }
  }
}

parabol_query

Escape hatch: run an arbitrary Parabol GraphQL QUERY (read-only) against action.parabol.co/graphql with optional variables. Mutations are REJECTED — use the dedicated write tools or parabol_graphql for those. Useful for fields not covered by the curated read tools. Requires the matching read scope(s) on your token.

read-only

Argument	Type	Description
query*	string	A GraphQL query document (must be a query, not a mutation).
variables	object	Variables object for the query.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "A GraphQL query document (must be a query, not a mutation)."
    },
    "variables": {
      "type": "object",
      "description": "Variables object for the query.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

parabol_start_checkin

MUTATES Parabol data: start a new Check-in (Action) meeting for a team (returns the new meetingId). Required: teamId. Optionally name it. Parabol GraphQL: startCheckIn → union. Requires MEETINGS_WRITE.

destructive

Argument	Type	Description
name	string	Optional meeting name.
teamId*	string	The team id (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional meeting name."
    },
    "teamId": {
      "type": "string",
      "description": "The team id (required)."
    }
  }
}

parabol_start_retrospective

MUTATES Parabol data: start a new retrospective meeting for a team (returns the new meetingId). Required: teamId. Optionally name it. Parabol GraphQL: startRetrospective → union. Requires MEETINGS_WRITE.

destructive

Argument	Type	Description
name	string	Optional meeting name.
teamId*	string	The team id to run the retro for (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional meeting name."
    },
    "teamId": {
      "type": "string",
      "description": "The team id to run the retro for (required)."
    }
  }
}

parabol_start_team_prompt

MUTATES Parabol data: start a new async Standup (Team Prompt) meeting for a team. Required: teamId. Optionally name it (default 'Standup'). Parabol GraphQL: startTeamPrompt → union. Requires MEETINGS_WRITE.

destructive

Argument	Type	Description
name	string	Optional meeting name (default 'Standup').
teamId*	string	The team id (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "teamId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional meeting name (default 'Standup')."
    },
    "teamId": {
      "type": "string",
      "description": "The team id (required)."
    }
  }
}

parabol_update_task

MUTATES Parabol data: update an existing task. Required: id. Optionally change content (stringified TipTap JSON), status, assignee (userId), or sortOrder. Only included fields change. Parabol GraphQL: updateTask(updatedTask, area). Requires TASKS_WRITE.

destructive

Argument	Type	Description
id*	string	The task id (required).
area	string	Optional AreaEnum context.
fields	object	Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).
status	string	New status (TaskStatusEnum).
userId	string	Reassign the task to this user id.
content	string	New rich-text content as a stringified TipTap/ProseMirror JSON document.
sortOrder	number	New sort order (Float).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The task id (required)."
    },
    "area": {
      "type": "string",
      "description": "Optional AreaEnum context."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented GraphQL input fields to send verbatim in this mutation's input (merged OVER the typed fields above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "status": {
      "enum": [
        "active",
        "stuck",
        "done",
        "future"
      ],
      "type": "string",
      "description": "New status (TaskStatusEnum)."
    },
    "userId": {
      "type": "string",
      "description": "Reassign the task to this user id."
    },
    "content": {
      "type": "string",
      "description": "New rich-text content as a stringified TipTap/ProseMirror JSON document."
    },
    "sortOrder": {
      "type": "number",
      "description": "New sort order (Float)."
    }
  }
}

Parabol MCP by usefulapi

Try it

parabol_add_comment Destructive

Parabol MCP by usefulapi

Try it

parabol_add_comment Destructive

Tools (21)