Skip to main content
With the peeps MCP server connected to Claude Desktop, Claude can answer questions about people and organizations directly from your peeps workspace — no copy-pasting contact details, no switching tabs. Ask Claude to find contacts, look up teammates, or surface people at specific companies, all within your normal conversation flow.

​
Prerequisites

  • A peeps API key (see Step 1 below)
  • Claude Desktop installed on your machine
  • Node.js 18 or later

​
Setup

1

Get your API key

Log in to app.peeps.ai, navigate to Settings → API Keys, and create a new key. Copy it somewhere safe — you’ll need it in the next steps.
2

Open Claude Desktop configuration

Claude Desktop stores its configuration in a JSON file on your machine. Open the file for your operating system:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
If the file doesn’t exist yet, create it at that path.
3

Add the peeps MCP server

Paste the following configuration into your claude_desktop_config.json, replacing your-api-key-here with the key you copied in Step 1. If the file already contains an mcpServers block, add the "peeps" entry inside the existing object rather than creating a second one.
claude_desktop_config.json
4

Restart Claude Desktop

Fully quit Claude Desktop and reopen it so it picks up the updated configuration. On macOS, right-click the dock icon and choose Quit rather than just closing the window.
5

Test the connection

Start a new conversation in Claude Desktop and type:
“Search for people named Alex in my peeps workspace.”
Claude should call the peeps MCP server and return matching contacts. If you see an error, double-check that your API key is correct and that Node.js 18+ is available in your PATH.

​
Example prompts

Once peeps is connected, try asking Claude things like:
  • “Find all contacts at Stripe in my peeps workspace.”
  • “Who is the CEO of Acme Corp in my contacts?”
  • “Show me recently added people in peeps.”
  • “Look up the contact details for Jordan Lee.”
  • “Which organizations in my peeps account are in the fintech industry?”
Use Claude Projects to give Claude persistent context about your team. Add a project instruction like “Use the peeps tools to look up any people or contacts I mention” so Claude automatically reaches for peeps data without being prompted each time.
Claude.ai web also supports remote MCP servers — no local Node.js required. Instead of the stdio config above, connect peeps using the HTTP/SSE endpoint. See Connect peeps to any MCP-compatible AI client for the remote server URL and authentication details.