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
- Call
list_connected_integrations.- Tool not available → MCP not connected. Present these steps inline to the user:
- Sign in at rarefriend.com → Settings → Integrations → MCP → copy the Client ID and Client Secret
- 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 - Cursor: add to
~/.cursor/mcp.jsonundermcpServers.rarefriendwithcommand: npx,args: ["-y", "@rarefriend-ai/mcp"], and the two env vars - Claude Desktop: add the same block to
claude_desktop_config.json - Restart the client, then try again
microsoft_emailnot in the list → offer to connect:connect_integration("microsoft_email").microsoft_emailpresent → proceed directly.
- Tool not available → MCP not connected. Present these steps inline to the user:
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 john@acme.com" →
search_microsoft_emails("john@acme.com")
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?"
search_microsoft_emails("person name")→ find relevant threadssearch_contacts("person name", searchMode="exact")→ find them in CRMlist_notes(contactId)→ review relationship notes- 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-contactsandschedule-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.