> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peepsai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the peeps MCP server with Claude Desktop and Claude.ai

> Set up the peeps MCP server in Claude Desktop so Claude can search and look up people and contacts directly in your conversations.

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](https://claude.ai/download) installed on your machine
* Node.js 18 or later

## Setup

<Steps>
  <Step title="Get your API key">
    Log in to [app.peeps.ai](https://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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    ```json claude_desktop_config.json theme={null}
    {
      "mcpServers": {
        "peeps": {
          "command": "npx",
          "args": ["-y", "@peeps-ai/mcp"],
          "env": {
            "PEEPS_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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`.
  </Step>
</Steps>

## 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?"

<Tip>
  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.
</Tip>

<Note>
  **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](/integrations/custom) for the remote server URL and authentication details.
</Note>