`pipedrive_list_persons`

Pack: pipedrive · Endpoint: https://gateway.pipeworx.io/pipedrive/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/pipedrive_list_persons for the schema, then POST the same URL with its arguments for the data.

View all contacts in your CRM. Returns names, email addresses, phone numbers, and associated organizations and deals.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Pipedrive API token
`start`	number	no	Pagination start (default 0)
`limit`	number	no	Number of results (max 500, default 50)

Example call

Arguments

{
  "_apiKey": "your-pipedrive-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/pipedrive/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pipedrive_list_persons","arguments":{"_apiKey":"your-pipedrive-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('pipedrive_list_persons', {
  "_apiKey": "your-pipedrive-api-key"
});

More examples

{
  "_apiKey": "your-pipedrive-api-key",
  "limit": 100
}

Response shape

Field	Type	Description
`success`	boolean	Whether the request succeeded
`data`	array	List of contacts
`additional_data`	object	Pagination and metadata

Full JSON Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request succeeded"
    },
    "data": {
      "type": "array",
      "description": "List of contacts",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Contact ID"
          },
          "name": {
            "type": "string",
            "description": "Contact name"
          },
          "email": {
            "type": "array",
            "description": "Email addresses",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Email address"
                }
              }
            }
          },
          "phone": {
            "type": "array",
            "description": "Phone numbers",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Phone number"
                }
              }
            }
          },
          "org_id": {
            "type": "number",
            "description": "Associated organization ID"
          }
        }
      }
    },
    "additional_data": {
      "type": "object",
      "description": "Pagination and metadata"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "pipedrive": {
      "url": "https://gateway.pipeworx.io/pipedrive/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

pipedrive_list_persons