Meetings

Every Meetings tool, with the scope it needs, its arguments and the API operation it calls.

8 tools

Create meetings

Changes data

atlas_meetings_create

Create a meeting record (title required; kind defaults to PAST, visibility to PRIVATE). Optionally set schedule, location, attendees, and freeform notes. Idempotent per MCP invocation.

Scope: meetings:write
Calls: POST /meetings
Example prompt: Create a meeting called Design Sync for tomorrow at 10am.

Arguments

Field	Type	Required
`title`	`string`	Yes
`description`	`string`	No
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No
`startsAt`	`string (date-time)`	No
`endsAt`	`string (date-time)`	No
`durationMin`	`integer`	No
`location`	`string`	No
`visibility`	`"PRIVATE" \| "TENANT" \| "INVITEES"`	No
`attendees`	`array of object`	No
`notes`	`string`	No

Get meetings

Read only

atlas_meetings_get

Return one meeting by id, including attendees, recordings, transcripts, and AI notes. 404 (or visibility 403) when the caller cannot read it.

Scope: meetings:read
Calls: GET /meetings/{id}
Example prompt: Show me the notes for meeting mtg_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.

Extract meeting insights

Changes data

atlas_meetings_insights_extract

Extract a meeting summary + action items from a stored transcript. Returns { summary, actionItems[] }. Heuristic today; LLM-backed extractor lands behind the same shape.

Scope: meetings:read
Calls: POST /v1/meeting-insights/extract
Example prompt: Summarize transcript tr_42 and pull the action items.

Arguments

Field	Type	Required	Description
`transcriptId`	`string`	Yes	Atlas meeting transcript id whose summary + action items to extract.

List meetings

Read only

atlas_meetings_list

List caller-visible meetings (visibility-filtered in the service), optionally by kind, owner, or an ISO start-time window. Returns a page of rows plus an opaque nextCursor for keyset pagination.

Scope: meetings:read
Calls: GET /meetings
Example prompt: List last week's meetings.

Arguments

Field	Type	Required	Description
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No	Filter to one meeting kind.
`ownerUserId`	`string`	No	Filter to one owner id.
`after`	`string (date-time)`	No	Only meetings starting at/after this ISO instant.
`before`	`string (date-time)`	No	Only meetings starting at/before this ISO instant.
`cursor`	`string`	No	Opaque pagination cursor from a prior page.
`limit`	`integer`	No

Generate meeting notes

Changes data

atlas_meetings_notes_generate

Regenerate the AI meeting notes (summary + action items) from the meeting's latest transcript. Returns the fresh MeetingAiSummary. Idempotent per MCP invocation.

Scope: meetings:write
Calls: POST /meetings/{id}/notes/regenerate
Example prompt: Regenerate the AI notes for meeting mtg_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.

Revoke meeting share links

Destructive

atlas_meetings_share_links_revoke

Revoke one public share link of a meeting, so its slug stops resolving to the minutes. The person supplies the slug, the last part of the share link they copy from the meeting in Atlas; no tool lists share links, because the slugs are credentials. Returns nothing on success. Requires update access to the meeting. Use this when a link was shared too widely or is no longer needed.

Scope: meetings:write
Calls: DELETE /meetings/{id}/share-links/{slug}
Example prompt: Revoke the public link to the minutes of the board review meeting.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	The meeting id.
`slug`	`string`	Yes	The slug of the share link to revoke, which the person copies from the meeting in Atlas.

Generate meeting transcripts

Changes data

atlas_meetings_transcripts_generate

Run server-side ASR on a meeting's latest cloud recording. Returns { id, status, text, segments, confidence, provider }. When ASR is not configured, status=FAILED and provider='not_configured' - no audio leaves Atlas. 400 when the meeting has no cloud recording.

Scope: ai:write
Calls: POST /v1/meetings/{id}/transcribe
Example prompt: Transcribe the QBR meeting and surface the action items.

Arguments

Field	Type	Required	Description
`meetingId`	`string`	Yes	The meeting must have a cloud recording on file.

Update meetings

Changes data

atlas_meetings_update

Patch a meeting by id: title, description, kind, schedule, location, attendees, or notes. Nullable fields accept null to clear them. Idempotent per MCP invocation.

Scope: meetings:write
Calls: PATCH /meetings/{id}
Example prompt: Move meeting mtg_123 to Friday and add Priya as an attendee.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.
`title`	`string`	No
`description`	`string \| null`	No
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No
`startsAt`	`string (date-time) \| null`	No
`endsAt`	`string (date-time) \| null`	No
`durationMin`	`integer \| null`	No
`location`	`string \| null`	No
`attendees`	`array of object`	No
`notes`	`string \| null`	No

Meetings

Every Meetings tool, with the scope it needs, its arguments and the API operation it calls.

8 tools

Create meetings

Changes data

atlas_meetings_create

Create a meeting record (title required; kind defaults to PAST, visibility to PRIVATE). Optionally set schedule, location, attendees, and freeform notes. Idempotent per MCP invocation.

Scope: meetings:write
Calls: POST /meetings
Example prompt: Create a meeting called Design Sync for tomorrow at 10am.

Arguments

Field	Type	Required
`title`	`string`	Yes
`description`	`string`	No
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No
`startsAt`	`string (date-time)`	No
`endsAt`	`string (date-time)`	No
`durationMin`	`integer`	No
`location`	`string`	No
`visibility`	`"PRIVATE" \| "TENANT" \| "INVITEES"`	No
`attendees`	`array of object`	No
`notes`	`string`	No

Get meetings

Read only

atlas_meetings_get

Return one meeting by id, including attendees, recordings, transcripts, and AI notes. 404 (or visibility 403) when the caller cannot read it.

Scope: meetings:read
Calls: GET /meetings/{id}
Example prompt: Show me the notes for meeting mtg_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.

Extract meeting insights

Changes data

atlas_meetings_insights_extract

Extract a meeting summary + action items from a stored transcript. Returns { summary, actionItems[] }. Heuristic today; LLM-backed extractor lands behind the same shape.

Scope: meetings:read
Calls: POST /v1/meeting-insights/extract
Example prompt: Summarize transcript tr_42 and pull the action items.

Arguments

Field	Type	Required	Description
`transcriptId`	`string`	Yes	Atlas meeting transcript id whose summary + action items to extract.

List meetings

Read only

atlas_meetings_list

List caller-visible meetings (visibility-filtered in the service), optionally by kind, owner, or an ISO start-time window. Returns a page of rows plus an opaque nextCursor for keyset pagination.

Scope: meetings:read
Calls: GET /meetings
Example prompt: List last week's meetings.

Arguments

Field	Type	Required	Description
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No	Filter to one meeting kind.
`ownerUserId`	`string`	No	Filter to one owner id.
`after`	`string (date-time)`	No	Only meetings starting at/after this ISO instant.
`before`	`string (date-time)`	No	Only meetings starting at/before this ISO instant.
`cursor`	`string`	No	Opaque pagination cursor from a prior page.
`limit`	`integer`	No

Generate meeting notes

Changes data

atlas_meetings_notes_generate

Regenerate the AI meeting notes (summary + action items) from the meeting's latest transcript. Returns the fresh MeetingAiSummary. Idempotent per MCP invocation.

Scope: meetings:write
Calls: POST /meetings/{id}/notes/regenerate
Example prompt: Regenerate the AI notes for meeting mtg_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.

Revoke meeting share links

Destructive

atlas_meetings_share_links_revoke

Scope: meetings:write
Calls: DELETE /meetings/{id}/share-links/{slug}
Example prompt: Revoke the public link to the minutes of the board review meeting.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	The meeting id.
`slug`	`string`	Yes	The slug of the share link to revoke, which the person copies from the meeting in Atlas.

Generate meeting transcripts

Changes data

atlas_meetings_transcripts_generate

Scope: ai:write
Calls: POST /v1/meetings/{id}/transcribe
Example prompt: Transcribe the QBR meeting and surface the action items.

Arguments

Field	Type	Required	Description
`meetingId`	`string`	Yes	The meeting must have a cloud recording on file.

Update meetings

Changes data

atlas_meetings_update

Patch a meeting by id: title, description, kind, schedule, location, attendees, or notes. Nullable fields accept null to clear them. Idempotent per MCP invocation.

Scope: meetings:write
Calls: PATCH /meetings/{id}
Example prompt: Move meeting mtg_123 to Friday and add Priya as an attendee.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Atlas meeting id.
`title`	`string`	No
`description`	`string \| null`	No
`kind`	`"PAST" \| "SCHEDULED" \| "LIVE"`	No
`startsAt`	`string (date-time) \| null`	No
`endsAt`	`string (date-time) \| null`	No
`durationMin`	`integer \| null`	No
`location`	`string \| null`	No
`attendees`	`array of object`	No
`notes`	`string \| null`	No