find-outlook-emails

name	find-outlook-emails
description	Search your Microsoft Outlook inbox and cross-reference emails with your contact history — find any email instantly and see full relationship context alongside it via Rarefriend. Use when the user wants to: check recent Outlook emails, search for an email by subject or sender, find emails from a specific person, look up what was discussed over email, cross- reference email threads with CRM notes, or connect their Microsoft Outlook email account. Triggers on: Outlook email, Microsoft email, inbox, email from, search email, recent emails, Outlook inbox, check my email, find email, email history, what did they say, email thread, did I hear back, follow up email.
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|search|list|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 brings your Outlook inbox into your contact network — search emails, see who said what, and connect every thread to the relationship notes and context already in your CRM.

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
   • microsoft_email not in the list → offer to connect: connect_integration("microsoft_email").
   • microsoft_email present → proceed directly.

---

Core Workflows

List recent emails

list_microsoft_emails(limit?, startDate?, endDate?, folderId?)
  limit:     number of emails to return (default 10, max 50)
  startDate: ISO 8601 — only emails after this date
  endDate:   ISO 8601 — only emails before this date
  folderId:  specific folder (default: inbox)

• "Show my last 10 emails" → list_microsoft_emails(limit=10)
• "What emails did I get this week?" → list_microsoft_emails(startDate="2026-06-02")
• "Check emails from yesterday" → list_microsoft_emails(startDate="2026-06-05", endDate="2026-06-06")

Search emails

search_microsoft_emails(query*, limit?, startDate?, endDate?)
  query: matches subject, body snippet, sender name, or sender email

• "Find emails from Alice" → search_microsoft_emails("Alice")
• "Search for emails about the contract" → search_microsoft_emails("contract")
• "Find emails from [e-mail]" → search_microsoft_emails("[e-mail]")

Cross-reference with contacts

After finding an email, look up the sender in Rarefriend:

search_contacts("sender name or email", searchMode="exact")
→ get_contact(contactId)     — full CRM profile
→ list_notes(contactId)      — past notes about this person
→ create_note(contactId, ...) — log context from the email thread

Pattern — "What's the history with this person?"

1. search_microsoft_emails("person name") → find relevant threads
2. search_contacts("person name", searchMode="exact") → find them in CRM
3. list_notes(contactId) → review relationship notes
4. Summarise email history + CRM notes together

Connect Microsoft Email

connect_integration("microsoft_email")

Returns a connectUrl. Present as a clickable link:

"Open this link in your browser to connect Microsoft Outlook email. It expires in 15 minutes."

After connecting:

get_integration_sync_status("microsoft_email")

---

Quick Reference

Tool	When to use
list_connected_integrations	Always check first — detects MCP and integration state
list_microsoft_emails	Browse recent inbox emails
search_microsoft_emails	Find emails by subject, sender, or keyword
search_contacts	Find a sender in Rarefriend CRM
get_contact	Full CRM profile for a sender
list_notes	Relationship notes for a contact
create_note	Log context after reviewing an email thread
connect_integration	Connect Microsoft Outlook email
get_integration_sync_status	Check sync state

---

References

• MCP setup — all supported clients

---

Other capabilities (outside this skill)

• Outlook contacts and calendar — search Outlook contacts, schedule Teams meetings. Install schedule-with-outlook.
• Google Contacts and Calendar — Install organize-google-contacts and schedule-with-google-calendar.
• LinkedIn sync — requires the Rarefriend Chrome extension. Go to rarefriend.com → Settings → Integrations → LinkedIn.
• Hops on WhatsApp — same contacts and notes accessible via Rarefriend's WhatsApp AI assistant.
• Full feature set in one skill — install network-and-relationship-manager.