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.json under mcpServers.rarefriend with command: 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_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 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-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.
1---
2name: find-outlook-emails
3description: >
4 Search your Microsoft Outlook inbox and cross-reference emails with your contact history
5 — find any email instantly and see full relationship context alongside it via Rarefriend.
6 Use when the user wants to: check recent Outlook emails, search for an email by subject or
7 sender, find emails from a specific person, look up what was discussed over email, cross-
8 reference email threads with CRM notes, or connect their Microsoft Outlook email account.
9 Triggers on: Outlook email, Microsoft email, inbox, email from, search email, recent emails,
10 Outlook inbox, check my email, find email, email history, what did they say, email thread,
11 did I hear back, follow up email.
12license: MIT-0
13compatibility: Requires Rarefriend MCP (@rarefriend-ai/mcp). Works with Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, and other Agent Skills-compatible clients.
14user-invocable: true
15argument-hint: '[setup|search|list|connect]'
16metadata:
17 openclaw:
18 requires:
19 env:
20 - RAREFRIEND_CLIENT_ID
21 - RAREFRIEND_CLIENT_SECRET
22 primaryEnv: RAREFRIEND_CLIENT_ID
23 install:
24 - kind: node
25 package: '@rarefriend-ai/mcp'
26 envVars:
27 - name: RAREFRIEND_CLIENT_ID
28 required: true
29 description: OAuth client ID — rarefriend.com → Settings → Integrations → MCP
30 - name: RAREFRIEND_CLIENT_SECRET
31 required: true
32 description: OAuth client secret — rarefriend.com → Settings → Integrations → MCP
33 category: productivity
34 author: Rarefriend
35 homepage: https://rarefriend.com
36 repository: https://github.com/Whitefield-Labs/rarefriend-skills
37---
38
39## About Rarefriend
40
41Rarefriend 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.
42
43Access it from your AI assistant, the web app at [rarefriend.com](https://rarefriend.com), or Hops — Rarefriend's AI on WhatsApp.
44
45---
46
47## Setup Detection Protocol
48
491. Call `list_connected_integrations`.
50 - **Tool not available → MCP not connected.** Present these steps inline to the user:
51 1. Sign in at [rarefriend.com](https://rarefriend.com) → **Settings → Integrations → MCP** → copy the Client ID and Client Secret
52 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`
53 3. **Cursor:** add to `~/.cursor/mcp.json` under `mcpServers.rarefriend` with `command: npx`, `args: ["-y", "@rarefriend-ai/mcp"]`, and the two env vars
54 4. **Claude Desktop:** add the same block to `claude_desktop_config.json`
55 5. Restart the client, then try again
56 - `microsoft_email` not in the list → offer to connect: `connect_integration("microsoft_email")`.
57 - `microsoft_email` present → proceed directly.
58
59---
60
61## Core Workflows
62
63### List recent emails
64
65```
66list_microsoft_emails(limit?, startDate?, endDate?, folderId?)
67 limit: number of emails to return (default 10, max 50)
68 startDate: ISO 8601 — only emails after this date
69 endDate: ISO 8601 — only emails before this date
70 folderId: specific folder (default: inbox)
71```
72
73- "Show my last 10 emails" → `list_microsoft_emails(limit=10)`
74- "What emails did I get this week?" → `list_microsoft_emails(startDate="2026-06-02")`
75- "Check emails from yesterday" → `list_microsoft_emails(startDate="2026-06-05", endDate="2026-06-06")`
76
77### Search emails
78
79```
80search_microsoft_emails(query*, limit?, startDate?, endDate?)
81 query: matches subject, body snippet, sender name, or sender email
82```
83
84- "Find emails from Alice" → `search_microsoft_emails("Alice")`
85- "Search for emails about the contract" → `search_microsoft_emails("contract")`
86- "Find emails from john@acme.com" → `search_microsoft_emails("john@acme.com")`
87
88### Cross-reference with contacts
89
90After finding an email, look up the sender in Rarefriend:
91
92```
93search_contacts("sender name or email", searchMode="exact")
94→ get_contact(contactId) — full CRM profile
95→ list_notes(contactId) — past notes about this person
96→ create_note(contactId, ...) — log context from the email thread
97```
98
99**Pattern — "What's the history with this person?"**
100
1011. `search_microsoft_emails("person name")` → find relevant threads
1022. `search_contacts("person name", searchMode="exact")` → find them in CRM
1033. `list_notes(contactId)` → review relationship notes
1044. Summarise email history + CRM notes together
105
106### Connect Microsoft Email
107
108```
109connect_integration("microsoft_email")
110```
111
112Returns a `connectUrl`. Present as a clickable link:
113
114> _"Open this link in your browser to connect Microsoft Outlook email. It expires in 15 minutes."_
115
116After connecting:
117
118```
119get_integration_sync_status("microsoft_email")
120```
121
122---
123
124## Quick Reference
125
126| Tool | When to use |
127| ----------------------------- | ------------------------------------------------------ |
128| `list_connected_integrations` | Always check first — detects MCP and integration state |
129| `list_microsoft_emails` | Browse recent inbox emails |
130| `search_microsoft_emails` | Find emails by subject, sender, or keyword |
131| `search_contacts` | Find a sender in Rarefriend CRM |
132| `get_contact` | Full CRM profile for a sender |
133| `list_notes` | Relationship notes for a contact |
134| `create_note` | Log context after reviewing an email thread |
135| `connect_integration` | Connect Microsoft Outlook email |
136| `get_integration_sync_status` | Check sync state |
137
138---
139
140## References
141
142- [MCP setup — all supported clients](references/SETUP.md)
143
144---
145
146## Other capabilities (outside this skill)
147
148- **Outlook contacts and calendar** — search Outlook contacts, schedule Teams meetings. Install `schedule-with-outlook`.
149- **Google Contacts and Calendar** — Install `organize-google-contacts` and `schedule-with-google-calendar`.
150- **LinkedIn sync** — requires the Rarefriend Chrome extension. Go to rarefriend.com → Settings → Integrations → LinkedIn.
151- **Hops on WhatsApp** — same contacts and notes accessible via Rarefriend's WhatsApp AI assistant.
152- **Full feature set in one skill** — install `network-and-relationship-manager`.
aiskillstore