# get_meetly_usage_guide

Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision.

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| skill_keys | array of string | No | Omit for the two core bodies; [] for guide and index only; select keys for complete specialist instructions and references. |

## What you get

- **guide:** The guide returned for your agent.
- **cloudAccess:** cloud Access returned by this tool. Includes: connected, readAllowed, contextWriteAllowed, source, indexCoverage, cloudSummaryRequired, cloudSummaryEnabled.
- **connectionInstructions:** connection Instructions returned by this tool.
- **userPreferences:** user Preferences returned by this tool. Includes: profile, revision, capabilities, requiredScopes.
- **preferenceStatus:** preference Status returned by this tool.
- **preferenceInstructions:** preference Instructions returned by this tool.
- **currency:** Which release checks were completed.
- **distributionError:** distribution Error returned by this tool.
- **sourceTools:** source Tools returned by this tool.
- **workflows:** workflows returned by this tool. Includes: name, activation, useWhen, instructions, files.

## Example

Load the current Guide and account access status. Select skill keys only when the relevant workflow is needed.

Call `get_meetly_usage_guide` with:

```json
{
  "skill_keys": []
}
```

Illustrative input, checked against this catalog at build time.

## Full description

Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision. Useful when getting started, choosing a meeting workflow, or reading the profile before a confirmed preference update. Optional skill_keys selects detailed workflow documentation returned in this response. Does not save preferences, install skills, create schedules, or send messages.

Read-only · Server 0.17.0

Source commit: 6cc62bc5b29fb3bf09648dc755c8f5a26ea54d18

## Tool definition

```json
{
  "name": "get_meetly_usage_guide",
  "title": "Get Meetly setup and preferences",
  "description": "Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision. Useful when getting started, choosing a meeting workflow, or reading the profile before a confirmed preference update. Optional skill_keys selects detailed workflow documentation returned in this response. Does not save preferences, install skills, create schedules, or send messages.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true,
    "title": "Get Meetly setup and preferences"
  },
  "securitySchemes": [
    {
      "type": "oauth2",
      "scopes": [
        "meetings:read"
      ]
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "oauth2",
        "scopes": [
          "meetings:read"
        ]
      }
    ],
    "openai/toolInvocation/invoking": "Loading Meetly workflows…",
    "openai/toolInvocation/invoked": "Meetly workflows ready"
  },
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "skill_keys": {
        "type": "array",
        "maxItems": 7,
        "uniqueItems": true,
        "items": {
          "type": "string",
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
          "maxLength": 64
        },
        "description": "Omit for the two core bodies; [] for guide and index only; select keys for complete specialist instructions and references."
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "guide": {
        "type": "string"
      },
      "cloudAccess": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "connected": {
            "type": "boolean"
          },
          "readAllowed": {
            "type": "boolean"
          },
          "contextWriteAllowed": {
            "type": "boolean"
          },
          "source": {
            "const": "private_cloudkit"
          },
          "indexCoverage": {
            "const": "not_verified_complete"
          },
          "cloudSummaryRequired": {
            "const": false
          },
          "cloudSummaryEnabled": {
            "type": "null"
          }
        },
        "required": [
          "connected",
          "readAllowed",
          "contextWriteAllowed",
          "source",
          "indexCoverage",
          "cloudSummaryRequired",
          "cloudSummaryEnabled"
        ]
      },
      "connectionInstructions": {
        "type": "string"
      },
      "userPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "profile": {
            "anyOf": [
              {
                "type": "object",
                "maxProperties": 64,
                "propertyNames": {
                  "pattern": "^[a-z][A-Za-z0-9._-]{0,63}$"
                },
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 2000
                },
                "description": "User-approved preference notes only; up to 64 forward-compatible fields and 8192 UTF-8 JSON bytes. Field names start with a lowercase letter and contain only letters, digits, dot, underscore or hyphen. Intended for preference notes, not secrets, transcripts, host memory or unrelated documents. Schedule notes are preferences, not a scheduler."
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "capabilities": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "read": {
                "type": "boolean"
              },
              "write": {
                "type": "boolean"
              }
            },
            "required": [
              "read",
              "write"
            ]
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "profile",
          "revision",
          "capabilities",
          "requiredScopes"
        ]
      },
      "preferenceStatus": {
        "type": "string",
        "enum": [
          "ready",
          "scope_required",
          "native_migration_required",
          "unavailable"
        ]
      },
      "preferenceInstructions": {
        "type": "string"
      },
      "currency": {
        "type": "string",
        "enum": [
          "verified",
          "unchecked"
        ]
      },
      "distributionError": {
        "type": "string"
      },
      "sourceTools": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "search",
            "fetch",
            "list_meetings",
            "get_transcript",
            "get_summary"
          ]
        }
      },
      "workflows": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "name": {
              "type": "string"
            },
            "activation": {
              "type": "string",
              "enum": [
                "default",
                "explicit"
              ]
            },
            "useWhen": {
              "type": "string"
            },
            "instructions": {
              "type": "string"
            },
            "files": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "path": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "path",
                  "text"
                ]
              }
            }
          },
          "required": [
            "name",
            "activation",
            "useWhen",
            "instructions"
          ]
        }
      }
    },
    "required": [
      "guide",
      "sourceTools",
      "workflows"
    ]
  }
}
```

[All tools](/tools/)