List meetings
list_meetingsList a project's scheduled and past meetings with times, locations, and IDs. Find upcoming meetings or retrieve a meeting ID to access details and agenda items.
Instructions
List meetings — the schedule side of a project: what is coming up, what already ran.
Use it to answer "when do we next meet", "what meetings does this project have", or to
find the meeting id that get_meeting and add_meeting_agenda_item need. Meeting ids
are instance-wide and never guessable, so this is the way to get one.
Returns the standard list envelope: rows of {id, title, project, start_time, end_time, duration_hours, location, state} plus pagination and notes. Times are ISO 8601 UTC
and duration_hours is a float (1.5 = 90 minutes). Rows are ordered by start time —
ascending when upcoming_only, descending otherwise.
Pitfalls. Cancelled meetings and recurring-series templates are excluded upstream, so an
absent meeting may exist in another state. state of 'draft' means the meeting has not
been opened to its participants yet. Agenda items and participants are NOT in these rows;
get_meeting fetches them. Meetings are a module: when it is not installed here or not
enabled in the project (404), or this account may not read meetings (403), the call still
SUCCEEDS with an empty items and the reason in notes — read notes before saying a
project has no meetings, because an empty list with a note is not an empty schedule.
Cross-references: get_meeting(meeting_id=...) for participants, agenda and outcomes;
create_meeting to schedule one; list_projects for the project id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. | |
| page_size | No | Meetings per page (max 100). | |
| project_id | No | Numeric project id to list only that project's meetings, from list_projects. Unlike most project parameters this one takes the id only — the meetings filter rejects a URL identifier, and passing one fails immediately with that explanation. Omit for every meeting visible to you. | |
| upcoming_only | No | True (the default) lists meetings that have not finished yet, soonest first. False lists past meetings too, most recent first — use it for 'what did we discuss last week'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sums | No | Present only when show_sums was requested. | |
| items | No | The page of results. | |
| notes | No | Degradation markers: capped aggregations, unavailable modules, … | |
| groups | No | Present only when group_by was requested. | |
| pagination | Yes | Total/page/page_size/has_more. |