Meetly agent reference

list_meetings

Read-only · list_meetings

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

Inputs

NameTypeRequiredDescription
fromnumberNoMilliseconds since Unix epoch; inclusive meeting-date lower bound.
tonumberNoMilliseconds since Unix epoch; exclusive meeting-date upper bound.
querystringNoOptional case-insensitive filter over meeting title and preview.
limitnumberNoMaximum results; defaults to 25. Minimum: 1. Maximum: 100.
cursornumberNoZero-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:

{}

Illustrative input, checked against this catalog at build time.

Full description from the catalog

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.

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": "number",
      "minimum": 0,
      "description": "Zero-based result offset; defaults to 0."
    }
  }
}
Output schema
{
  "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"
  ]
}
Full tool definition and annotations
{
  "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"
    ]
  }
}

Server 0.8.0 · Source commit 13743ab0fd1289fa2dd1cfc2bf08ed34a9fb1040

← All tools