mcpbeat

Google Calendar Group Scheduler

openai/google-calendar-group-scheduler

Find and rank good meeting times for multiple people using connected Google Calendar data. Use when the user wants to schedule a group meeting, compare candidate slots across several attendees, find the best compromise time, or add a room check after narrowing the attendee-compatible options.

23k tokens
context cost
the whole folder, loaded on every use
4
files
instructions only
0
copies elsewhere
how many repositories repackaged it
4915
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/openai/plugins --skill google-calendar-group-scheduler

What comes with it

91 094 bytes besides the instruction
agents/openai.yaml
assets/icon.png
assets/logo.png

The instruction itself

5 sections, as written by the author

Google Calendar Group Scheduler

Use this skill when the scheduling problem is the task.

Relevant Actions

  • Use get_availability for attendee and room/resource busy windows once you know the concrete calendar IDs.
  • Use search_events when you need event context, candidate-room history, or a clearer read on what is creating conflicts.
  • Use read_event or search_events_all_fields when the attendee emails, manager contact, room email, or full source-event details need to be recovered from existing calendar events.

Workflow

  • Ground the scheduling problem first: date window, duration, timezone, required attendees, optional attendees, and any hard constraints such as "this week", "afternoons only", or "avoid lunch".
  • Normalize the request into explicit candidate windows before ranking anything.
  • If attendee or room identities are referenced indirectly, such as "my manager", "same attendees", or "the room we usually use", search a bounded relevant window and read the likely source event before asking the user for contact details.
  • Rank slots, do not enumerate everything. Optimize for a short list of strong options.
  • Prefer slots that minimize conflict cost, are reasonably fair across timezones, and avoid fragmenting the day for the most constrained attendees.
  • If no perfect slot exists, return the best compromise and state exactly who is impacted.
  • If the meeting also needs a room, first narrow to attendee-compatible slots, then check likely rooms or resources against those shortlisted times.

Ranking Heuristics

  • Favor required-attendee fit over optional-attendee fit.
  • Favor slots that avoid very early or very late local times for distributed attendees.
  • Favor slots that preserve lunch and avoid consuming the only large free block in someone's day unless the meeting is clearly important.
  • Favor a small number of high-confidence options over a long weak list.
  • When two slots are similar, prefer the one that causes less calendar fragmentation.

Output Conventions

  • Return 2-4 candidate slots by default.
  • For each slot, say why it works and who, if anyone, would be inconvenienced.
  • If there is no clean option, say what tradeoff the best slot is making.

How to use it

Copy the folder

Take openai/google-calendar-group-scheduler from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.