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

# Quickstart: Connect the peeps MCP server in minutes

> Connect the peeps MCP server to Claude Desktop or Cursor in minutes. Get your API key, install the server, and start asking your AI about people.

This guide walks you through connecting the peeps MCP server to your AI assistant. By the end, you'll have a working setup that lets your AI look up people, contacts, and organizations from your peeps workspace — all through natural language.

## Prerequisites

Before you begin, make sure you have:

* A peeps account — [sign up at app.peeps.ai](https://app.peeps.ai) if you don't have one yet
* **Node.js 18 or later** installed on your machine ([download Node.js](https://nodejs.org))

## Setup

<Steps>
  <Step title="Get your API key">
    Log in to [app.peeps.ai](https://app.peeps.ai) and navigate to **Settings → API Keys**. Click **Create new key**, give it a descriptive name (for example, `claude-desktop`), and copy the generated key.

    <Warning>
      Your API key is shown only once at creation time. Store it somewhere safe — if you lose it, you'll need to generate a new one.
    </Warning>
  </Step>

  <Step title="Install the MCP server">
    The peeps MCP server is published as an npm package. The quickest way to run it is with `npx`, which requires no global installation:

    ```bash theme={null}
    npx @peeps-ai/mcp
    ```

    Alternatively, install it globally so it's always available on your `PATH`:

    ```bash theme={null}
    npm install -g @peeps-ai/mcp
    ```
  </Step>

  <Step title="Configure your MCP client">
    Add the peeps server to your MCP client's configuration file. Below is the configuration for **Claude Desktop** — open your `claude_desktop_config.json` file and add the `peeps` entry under `mcpServers`:

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

    Replace `your-api-key-here` with the key you copied in step 1. Save the file and restart Claude Desktop to apply the change.

    <Note>
      The config file location depends on your OS. On macOS it lives at `~/Library/Application Support/Claude/claude_desktop_config.json`; on Windows at `%APPDATA%\Claude\claude_desktop_config.json`.
    </Note>
  </Step>

  <Step title="Ask your AI about people">
    Open a new conversation in your AI assistant and try one of these prompts to confirm everything is working:

    * "Find everyone named Sarah at Acme Corp."
    * "Look up John Smith's contact details."
    * "Show me all contacts at Globex Corporation."
    * "What organizations do we have in peeps?"

    Your AI will call the peeps MCP server behind the scenes and return real data from your workspace.
  </Step>
</Steps>

<Tip>
  Want to see everything your AI can do with peeps? Check out the [Tools Reference](/mcp/tools) for a full list of available operations, including search filters, field descriptions, and example responses.
</Tip>