# list_meetings

Use this to browse authorized meeting history or select meetings for a daily briefing.

## 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 | number | No | Zero-based result offset; defaults to 0. Minimum: 0. |

## What you get

- **meetings:** Meetings matching your request. Includes: id, title, dateIso, durationSec, previewPlain, participants, actionItemCount.
- **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.

## Example

Browse recent meetings with the defaults. Dates are optional; this example sends no date filter or other arguments.

Call `list_meetings` with:

```json
{}
```

Illustrative input, checked against this catalog at build time.

## Full description

Use this to browse authorized meeting history or select meetings for a daily briefing. Lists discovery metadata newest first; previews and action counts may be generated and are not evidence, and participants do not prove attendance or speaking. Use fetch for transcript evidence or get_transcript for bounded pages.

Read-only · Server 0.9.1

Source commit: c52988b5026fecbbc29ea5a3bf29c2c601ca314a

## Tool definition

```json
{
  "name": "list_meetings",
  "title": "List Meetly meetings",
  "description": "Use this to browse authorized meeting history or select meetings for a daily briefing. Lists discovery metadata newest first; previews and action counts may be generated and are not evidence, and participants do not prove attendance or speaking. Use fetch for transcript evidence or get_transcript for bounded pages.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  },
  "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": "number",
        "minimum": 0,
        "description": "Zero-based result offset; defaults to 0."
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "meetings": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "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"
            }
          },
          "required": [
            "id",
            "title",
            "dateIso",
            "durationSec",
            "previewPlain",
            "participants",
            "actionItemCount"
          ]
        }
      },
      "total": {
        "type": "number"
      },
      "nextCursor": {
        "type": [
          "number",
          "null"
        ]
      },
      "note": {
        "type": "string"
      }
    },
    "required": [
      "meetings",
      "total",
      "nextCursor"
    ]
  }
}
```

[All tools](/tools/)