Read-only · list_meetings
List authorized meetings by local calendar day (calendarDate YYYY-MM-DD or period today/previous_calendar_day, each with an IANA timezone), by epoch from/to, title tokens or exact tags.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
from | number | No | Milliseconds since Unix epoch; inclusive meeting-date lower bound. |
to | number | No | Milliseconds since Unix epoch; exclusive meeting-date upper bound. |
query | string | No | Optional case-insensitive filter over meeting title and preview. |
limit | number | No | Maximum results; defaults to 25. Minimum: 1. Maximum: 100. |
cursor | string or number or null | No | No description supplied by the catalog. |
timezone | string | No | IANA timezone of the user (e.g. Asia/Singapore). Required with calendarDate or period; defines local calendar days. |
calendarDate | string | No | Local calendar date YYYY-MM-DD in timezone; returns meetings from local 00:00 to the next local 00:00 (DST-aware). Mutually exclusive with from/to and period. |
period | string | No | Relative local day, resolved by the server clock in timezone. previous_calendar_day is the whole local date before today's, regardless of when the run executes. The resolved date is returned in resolvedInterval.localDate. Allowed values: "today", "previous_calendar_day". |
tagsAll | array of string | No | No description supplied by the catalog. |
titleQuery | string | No | No description supplied by the catalog. |
summaryQuery | string | No | Optional saved-summary/topic scan; at most five candidates per page, paged with nextCursor; not a full-transcript or complete-library search. |
What you get
meetings- Meetings matching your request.Includes: id, title, dateIso, durationSec, previewPlain, participants, actionItemCount, meetingReference, localDate, openUrl, sourceUrl, appDeepLink, discoveryTitle, tags, canonicalRevision, metadataRevision, sourceReadiness, agentContextStale.
nextCursor- Where to continue reading; null means there are no more pages.
total- The total number of matching meetings.
note- Additional information about these results.
resolvedInterval- Absolute interval actually queried: localDate, timezone, from/to (epoch ms, [from,to)), fromIso/toIso with the local offset, basis, and resolvedAt for relative periods.
syncCoverage- What the server can establish about late-syncing recordings. status: sync_pending (listed meetings lack a readable transcript), unknown (no device watermark; completeness cannot be verified). complete_through is reserved and emitted only when a verified watermark exists. lateArrivalPossible means recordings from this period may still arrive.Includes: status, through, lastSyncAt, lateArrivalPossible.
More response fields
totalIsExact- total Is Exact returned by this tool.
indexCoverage- index Coverage returned by this tool.
discoveryOnly- discovery Only returned by this tool.
summaryCoverage- summary Coverage returned by this tool.
Example
Browse recent meetings with the defaults. Dates are optional; this example sends no date filter or other arguments.
Call list_meetings with:
{}Illustrative input, checked against this catalog at build time.
Full description from the catalog
List authorized meetings by local calendar day (calendarDate YYYY-MM-DD or period today/previous_calendar_day, each with an IANA timezone), by epoch from/to, title tokens or exact tags. Each meeting has id, title, meetingReference (MTLY-N human reference), dateIso, localDate, openUrl (optional user-facing link), appDeepLink, sourceUrl (evidence resource, not a link to show) and sourceReadiness. The response has resolvedInterval (the absolute local day actually queried, with fromIso/toIso) and syncCoverage (whether recordings may still be arriving and how far sync is verified). Paged with nextCursor. Optional summaryQuery scans saved summaries, five per page.
Input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"from": {
"type": "number",
"description": "Milliseconds since Unix epoch; inclusive meeting-date lower bound."
},
"to": {
"type": "number",
"description": "Milliseconds since Unix epoch; exclusive meeting-date upper bound."
},
"query": {
"type": "string",
"description": "Optional case-insensitive filter over meeting title and preview."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 100,
"description": "Maximum results; defaults to 25."
},
"cursor": {
"type": [
"string",
"number",
"null"
]
},
"timezone": {
"type": "string",
"description": "IANA timezone of the user (e.g. Asia/Singapore). Required with calendarDate or period; defines local calendar days."
},
"calendarDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Local calendar date YYYY-MM-DD in timezone; returns meetings from local 00:00 to the next local 00:00 (DST-aware). Mutually exclusive with from/to and period."
},
"period": {
"type": "string",
"enum": [
"today",
"previous_calendar_day"
],
"description": "Relative local day, resolved by the server clock in timezone. previous_calendar_day is the whole local date before today's, regardless of when the run executes. The resolved date is returned in resolvedInterval.localDate."
},
"tagsAll": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
},
"titleQuery": {
"type": "string"
},
"summaryQuery": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Optional saved-summary/topic scan; at most five candidates per page, paged with nextCursor; not a full-transcript or complete-library search."
}
}
}Output schema
{
"type": "object",
"additionalProperties": true,
"properties": {
"meetings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"dateIso": {
"type": "string",
"format": "date-time"
},
"durationSec": {
"type": "number"
},
"previewPlain": {
"type": "string"
},
"participants": {
"type": "array",
"items": {
"type": "string"
}
},
"actionItemCount": {
"type": "number"
},
"meetingReference": {
"type": [
"string",
"null"
],
"description": "Human reference (MTLY-N); null until assigned."
},
"localDate": {
"type": "string",
"description": "Recording date (YYYY-MM-DD) in the requested timezone."
},
"openUrl": {
"type": "string",
"format": "uri",
"description": "Optional user-facing HTTPS link for this meeting (https://www.getmeetly.ai/open/meeting/<uuid>). Opens the exact meeting where the installed Meetly app supports meeting links, otherwise a Meetly page with Open in Meetly and App Store actions. The meeting is identified by its title and meetingReference (MTLY-N)."
},
"sourceUrl": {
"type": "string",
"format": "uri",
"description": "MCP evidence resource for citation provenance (https://mcp.getmeetly.ai/mcp/sources/meetings/<uuid>). Not a meeting-opening link and not a substitute for openUrl."
},
"appDeepLink": {
"type": "string",
"description": "Native link (meetly://meeting/<uuid>) for native clients that hand off to the app directly; openUrl is the cross-platform link."
},
"discoveryTitle": {
"type": [
"string",
"null"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"canonicalRevision": {
"type": [
"number",
"null"
]
},
"metadataRevision": {
"type": "number"
},
"sourceReadiness": {
"type": "string",
"description": "complete when the transcript is readable; pending or source_not_synced otherwise."
},
"agentContextStale": {
"type": "boolean"
}
},
"required": [
"id",
"title",
"dateIso",
"durationSec",
"previewPlain",
"participants",
"actionItemCount"
]
}
},
"total": {
"type": [
"number",
"null"
]
},
"nextCursor": {
"type": [
"string",
"number",
"null"
]
},
"note": {
"type": "string"
},
"resolvedInterval": {
"type": "object",
"description": "Absolute interval actually queried: localDate, timezone, from/to (epoch ms, [from,to)), fromIso/toIso with the local offset, basis, and resolvedAt for relative periods.",
"additionalProperties": true
},
"syncCoverage": {
"type": "object",
"description": "What the server can establish about late-syncing recordings. status: sync_pending (listed meetings lack a readable transcript), unknown (no device watermark; completeness cannot be verified). complete_through is reserved and emitted only when a verified watermark exists. lateArrivalPossible means recordings from this period may still arrive.",
"additionalProperties": true,
"properties": {
"status": {
"enum": [
"complete_through",
"sync_pending",
"backfill_in_progress",
"known_incomplete",
"unknown"
]
},
"through": {
"type": [
"string",
"null"
]
},
"lastSyncAt": {
"type": [
"string",
"null"
]
},
"lateArrivalPossible": {
"type": "boolean"
}
}
},
"totalIsExact": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"indexCoverage": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"discoveryOnly": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"summaryCoverage": {
"type": [
"string",
"boolean",
"object",
"null"
]
}
},
"required": [
"meetings",
"total",
"nextCursor"
]
}Full tool definition and annotations
{
"name": "list_meetings",
"title": "List Meetly meetings",
"description": "List authorized meetings by local calendar day (calendarDate YYYY-MM-DD or period today/previous_calendar_day, each with an IANA timezone), by epoch from/to, title tokens or exact tags. Each meeting has id, title, meetingReference (MTLY-N human reference), dateIso, localDate, openUrl (optional user-facing link), appDeepLink, sourceUrl (evidence resource, not a link to show) and sourceReadiness. The response has resolvedInterval (the absolute local day actually queried, with fromIso/toIso) and syncCoverage (whether recordings may still be arriving and how far sync is verified). Paged with nextCursor. Optional summaryQuery scans saved summaries, five per page.",
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"idempotentHint": true,
"title": "List Meetly meetings"
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"meetings:read"
]
}
],
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"meetings:read"
]
}
],
"openai/toolInvocation/invoking": "Finding meetings…",
"openai/toolInvocation/invoked": "Meetings ready"
},
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"from": {
"type": "number",
"description": "Milliseconds since Unix epoch; inclusive meeting-date lower bound."
},
"to": {
"type": "number",
"description": "Milliseconds since Unix epoch; exclusive meeting-date upper bound."
},
"query": {
"type": "string",
"description": "Optional case-insensitive filter over meeting title and preview."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 100,
"description": "Maximum results; defaults to 25."
},
"cursor": {
"type": [
"string",
"number",
"null"
]
},
"timezone": {
"type": "string",
"description": "IANA timezone of the user (e.g. Asia/Singapore). Required with calendarDate or period; defines local calendar days."
},
"calendarDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Local calendar date YYYY-MM-DD in timezone; returns meetings from local 00:00 to the next local 00:00 (DST-aware). Mutually exclusive with from/to and period."
},
"period": {
"type": "string",
"enum": [
"today",
"previous_calendar_day"
],
"description": "Relative local day, resolved by the server clock in timezone. previous_calendar_day is the whole local date before today's, regardless of when the run executes. The resolved date is returned in resolvedInterval.localDate."
},
"tagsAll": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
},
"titleQuery": {
"type": "string"
},
"summaryQuery": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Optional saved-summary/topic scan; at most five candidates per page, paged with nextCursor; not a full-transcript or complete-library search."
}
}
},
"outputSchema": {
"type": "object",
"additionalProperties": true,
"properties": {
"meetings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"dateIso": {
"type": "string",
"format": "date-time"
},
"durationSec": {
"type": "number"
},
"previewPlain": {
"type": "string"
},
"participants": {
"type": "array",
"items": {
"type": "string"
}
},
"actionItemCount": {
"type": "number"
},
"meetingReference": {
"type": [
"string",
"null"
],
"description": "Human reference (MTLY-N); null until assigned."
},
"localDate": {
"type": "string",
"description": "Recording date (YYYY-MM-DD) in the requested timezone."
},
"openUrl": {
"type": "string",
"format": "uri",
"description": "Optional user-facing HTTPS link for this meeting (https://www.getmeetly.ai/open/meeting/<uuid>). Opens the exact meeting where the installed Meetly app supports meeting links, otherwise a Meetly page with Open in Meetly and App Store actions. The meeting is identified by its title and meetingReference (MTLY-N)."
},
"sourceUrl": {
"type": "string",
"format": "uri",
"description": "MCP evidence resource for citation provenance (https://mcp.getmeetly.ai/mcp/sources/meetings/<uuid>). Not a meeting-opening link and not a substitute for openUrl."
},
"appDeepLink": {
"type": "string",
"description": "Native link (meetly://meeting/<uuid>) for native clients that hand off to the app directly; openUrl is the cross-platform link."
},
"discoveryTitle": {
"type": [
"string",
"null"
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"canonicalRevision": {
"type": [
"number",
"null"
]
},
"metadataRevision": {
"type": "number"
},
"sourceReadiness": {
"type": "string",
"description": "complete when the transcript is readable; pending or source_not_synced otherwise."
},
"agentContextStale": {
"type": "boolean"
}
},
"required": [
"id",
"title",
"dateIso",
"durationSec",
"previewPlain",
"participants",
"actionItemCount"
]
}
},
"total": {
"type": [
"number",
"null"
]
},
"nextCursor": {
"type": [
"string",
"number",
"null"
]
},
"note": {
"type": "string"
},
"resolvedInterval": {
"type": "object",
"description": "Absolute interval actually queried: localDate, timezone, from/to (epoch ms, [from,to)), fromIso/toIso with the local offset, basis, and resolvedAt for relative periods.",
"additionalProperties": true
},
"syncCoverage": {
"type": "object",
"description": "What the server can establish about late-syncing recordings. status: sync_pending (listed meetings lack a readable transcript), unknown (no device watermark; completeness cannot be verified). complete_through is reserved and emitted only when a verified watermark exists. lateArrivalPossible means recordings from this period may still arrive.",
"additionalProperties": true,
"properties": {
"status": {
"enum": [
"complete_through",
"sync_pending",
"backfill_in_progress",
"known_incomplete",
"unknown"
]
},
"through": {
"type": [
"string",
"null"
]
},
"lastSyncAt": {
"type": [
"string",
"null"
]
},
"lateArrivalPossible": {
"type": "boolean"
}
}
},
"totalIsExact": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"indexCoverage": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"discoveryOnly": {
"type": [
"string",
"boolean",
"object",
"null"
]
},
"summaryCoverage": {
"type": [
"string",
"boolean",
"object",
"null"
]
}
},
"required": [
"meetings",
"total",
"nextCursor"
]
}
}Server 0.17.0 · Source commit 6cc62bc5b29fb3bf09648dc755c8f5a26ea54d18