schedule-with-google-calendar

name	schedule-with-google-calendar
description	Schedule meetings, find free time, and manage Google Calendar — all connected to your contact network via Rarefriend. Resolve attendees by name, log notes after calls, and never double-book again. Use when the user wants to: schedule a meeting, check what's on their calendar, find a free slot, reschedule or cancel an event, block focus time, find available time for multiple attendees, look up a contact before creating an event, or log notes after a meeting. Triggers on: schedule, calendar, meeting, event, Google Calendar, free slot, available time, book, reschedule, cancel event, block time, standup, call, appointment, what's on my calendar, am I free, set up a call, when are we meeting.
license	MIT-0
compatibility	Requires Rarefriend MCP (@rarefriend-ai/mcp). Works with Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, and other Agent Skills-compatible clients.
user-invocable	true
argument-hint	[setup|schedule|find-time|reschedule|cancel|connect]
metadata	{"openclaw":{"requires":{"env":["RAREFRIEND_CLIENT_ID","RAREFRIEND_CLIENT_SECRET"],"primaryEnv":"RAREFRIEND_CLIENT_ID"},"install":[{"kind":"node","package":"@rarefriend-ai/mcp"}],"envVars":[{"name":"RAREFRIEND_CLIENT_ID","required":true,"description":"OAuth client ID — rarefriend.com → Settings → Integrations → MCP"},{"name":"RAREFRIEND_CLIENT_SECRET","required":true,"description":"OAuth client secret — rarefriend.com → Settings → Integrations → MCP"}]},"category":"productivity","author":"Rarefriend","homepage":"https://rarefriend.com","repository":"https://github.com/Whitefield-Labs/rarefriend-skills"}

About Rarefriend

Rarefriend connects your calendar to your contact network — schedule meetings with people you know, log context after every call, and keep your professional relationships fully searchable.

Access it from your AI assistant, the web app at rarefriend.com, or Hops — Rarefriend's AI on WhatsApp.

---

Setup Detection Protocol

1. Call list_connected_integrations.
   • Tool not available → MCP not connected. Present these steps inline to the user:
     1. Sign in at rarefriend.com → Settings → Integrations → MCP → copy the Client ID and Client Secret
     2. Claude Code / Codex: run claude mcp add rarefriend -e RAREFRIEND_CLIENT_ID=your_id -e RAREFRIEND_CLIENT_SECRET=your_secret -- npx -y @rarefriend-ai/mcp
     3. Cursor: add to ~/.cursor/mcp.json under mcpServers.rarefriend with command: npx, args: ["-y", "@rarefriend-ai/mcp"], and the two env vars
     4. Claude Desktop: add the same block to claude_desktop_config.json
     5. Restart the client, then try again
   • google_calendar not in the list → offer to connect: connect_integration("google_calendar").
   • google_calendar present → proceed directly.

---

Core Workflows

Check upcoming events

get_upcoming_google_events(limit?, days?)

Default: next 10 events. Use days to narrow to "today" or "this week".

Search for specific events

search_google_calendar_events(query, timeMin?, timeMax?)

Use when the user asks "find my meeting with X" or "what events do I have about Y this month".

Find available time

find_available_google_time(durationMinutes, preferredDays?,
                            preferredTimeRange?, attendeeEmails?)

Always call this before scheduling to avoid conflicts. For multi-person meetings, pass attendeeEmails — the tool checks all attendees' availability.

If the user gives a name instead of an email, resolve it first:

search_contacts("Alice Wang", searchMode="name")
→ extract email → pass to find_available_google_time