{
  "name": "notion-get-users",
  "title": "Get users and bots in workspace",
  "description": "Retrieves a list of users in the current workspace. Shows workspace members and guests with their IDs, names, emails (if available), and types (person or bot).\nSupports cursor-based pagination to iterate through all users in the workspace.\n<examples>\n1. List all users (first page): {}\n2. Search for users by name or email: {\"query\": \"john\"}\n3. Get next page of results: {\"start_cursor\": \"abc123\"}\n4. Set custom page size: {\"page_size\": 20}\n5. Fetch a specific user by ID: {\"user_id\": \"00000000-0000-4000-8000-000000000000\"}\n6. Fetch the current user: {\"user_id\": \"self\"}\n</examples>",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Optional search query to filter users by name or email (case-insensitive)."
      },
      "start_cursor": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Cursor for pagination. Use the next_cursor value from the previous response to get the next page."
      },
      "page_size": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Number of users to return per page (default: 100, max: 100)."
      },
      "user_id": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Return only the user matching this ID. Pass \"self\" to fetch the current user."
      }
    },
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#"
  }
}