pipedrive_get_person

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

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

Get full contact details by ID. Returns name, emails, phones, organization, associated deals, and custom fields.

Parameters

NameTypeRequiredDescription
_apiKeystringyesPipedrive API token
idnumberyesPerson ID

Example call

Arguments

{
  "_apiKey": "your-pipedrive-api-key",
  "id": 1
}

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_get_person","arguments":{"_apiKey":"your-pipedrive-api-key","id":1}}}'

TypeScript (@pipeworx/sdk)

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

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

Response shape

FieldTypeDescription
successbooleanWhether the request succeeded
dataobjectContact details
Full JSON Schema
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request succeeded"
    },
    "data": {
      "type": "object",
      "description": "Contact details",
      "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"
        },
        "add_time": {
          "type": "string",
          "description": "Creation timestamp"
        },
        "update_time": {
          "type": "string",
          "description": "Last update timestamp"
        }
      }
    }
  }
}

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.

Regenerated from source · build September 22, 2026