schedule-with-outlook

name	schedule-with-outlook
description	Manage Microsoft Outlook contacts and calendar from your AI assistant — search contacts, schedule Teams meetings, find free time, and keep relationship notes all in one place via Rarefriend. Use when the user wants to: search Outlook contacts, schedule an Outlook or Teams meeting, check their Outlook calendar, find free time, reschedule or cancel Outlook events, add notes about people, tag and organise their Microsoft network, or connect their Microsoft account. Triggers on: Outlook, Microsoft, Teams, Exchange, Office 365, Microsoft contacts, Outlook calendar, schedule Teams meeting, book meeting, free slot, Outlook contact, notes, tags, Microsoft calendar, Teams call, Office 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|contacts|calendar|notes|tags|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 Microsoft Outlook contacts and calendar to a full relationship layer — notes after every meeting, tags to organise your network, and instant recall on anyone in your Microsoft ecosystem.

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
   • No Microsoft integrations → offer to connect. Ask which they need: microsoft_contacts, microsoft_calendar, or microsoft_email.
   • Microsoft integrations present → proceed directly.

---

Core Workflows

Search contacts

Two search paths — use both for best results:

search_contacts(query, searchMode?, tag?, source?, limit?, offset?)
  source: 'microsoft_contacts'   — filter to only Outlook-synced contacts
  searchMode: 'all' | 'name' | 'company' | 'role' | 'email' | 'exact'
  tag: filter to contacts with this exact tag

search_microsoft_contacts(query, limit?)   — searches Outlook/Exchange directory directly
get_microsoft_contact(contactId)           — full Outlook contact details

Use search_contacts first (broader, includes notes and tags). Use search_microsoft_contacts when the user wants to look up the raw Outlook/Exchange directory.

Source attribution: Each contact includes sourceLabel (e.g. "Microsoft Contacts", "LinkedIn (extension)", "Google Contacts"). Always mention this — e.g. or .