organize-google-contacts

name	organize-google-contacts
description	Your Google Contacts — supercharged with notes, tags, and relationship memory via Rarefriend. Find anyone instantly, remember every conversation, and never lose context on a person again. Use when the user wants to: search people they know, find someone's email or phone, create or update a contact, add meeting notes or call summaries, tag contacts, bulk import a list of people, connect Google Contacts, or check what they know about someone. Triggers on: contact, contacts, Google Contacts, who do I know, find someone, person, people, notes about, meeting notes, tag, import contacts, network, what do I know about, who is, remember this about, add a note.
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|create|notes|tags|import|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 layers notes, tags, and relationship history on top of your Google Contacts — so every person you know comes with full context, not just a name and email.

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
   • Empty list → connected, no Google sync yet. Proceed; offer connect_integration("google_contacts") at the end.
   • google_contacts present → proceed directly.

---

Core Workflows

Search contacts

search_contacts(query, searchMode?, tag?, source?, limit?, offset?)
  searchMode: 'all' | 'name' | 'company' | 'role' | 'email' | 'exact'
  tag:        filter to contacts with this exact tag (e.g. "investor")
  source:     filter by origin — 'google_contacts' | 'manual' | 'mcp' | 'linkedin_csv' | ...

• "Who do I know at Stripe?" → search_contacts("Stripe", searchMode="company")
• "Show all my Google contacts" → search_contacts("", source="google_contacts")
• "Find all investors" → search_contacts("", tag="investor")
• Use searchMode: 'exact' for known email or full name.
• Pass offset + limit from the previous response when hasMore is true.

Source attribution: Each contact in the response includes source and sourceLabel (e.g. "Google Contacts", "LinkedIn (extension)", "Added manually"). Always mention this when presenting results — e.g. or .