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](https://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](https://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 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?"**

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](references/SETUP.md)

---

## 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`.