`pipedrive_search`

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

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

Search deals, contacts, organizations, products, or files by keyword. Returns matching records with IDs and basic info.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Pipedrive API token
`term`	string	yes	Search term
`item_types`	string	no	Comma-separated item types to search: deal, person, organization, product, file (default: all)
`limit`	number	no	Max results (default 50)

Example call

Arguments

{
  "_apiKey": "your-pipedrive-api-key",
  "term": "Acme Corp"
}

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_search","arguments":{"_apiKey":"your-pipedrive-api-key","term":"Acme Corp"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "_apiKey": "your-pipedrive-api-key",
  "term": "John Smith",
  "item_types": "person,deal"
}

Response shape

Field	Type	Description
`success`	boolean	Whether the request succeeded
`data`	object	Search results grouped by item type

Full JSON Schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request succeeded"
    },
    "data": {
      "type": "object",
      "description": "Search results grouped by item type",
      "properties": {
        "deals": {
          "type": "array",
          "description": "Matching deals",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "Deal ID"
              },
              "title": {
                "type": "string",
                "description": "Deal title"
              },
              "value": {
                "type": "number",
                "description": "Deal value"
              }
            }
          }
        },
        "persons": {
          "type": "array",
          "description": "Matching contacts",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "Contact ID"
              },
              "name": {
                "type": "string",
                "description": "Contact name"
              },
              "email": {
                "type": "string",
                "description": "Email address"
              }
            }
          }
        },
        "organizations": {
          "type": "array",
          "description": "Matching organizations",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "Organization ID"
              },
              "name": {
                "type": "string",
                "description": "Organization name"
              }
            }
          }
        },
        "products": {
          "type": "array",
          "description": "Matching products",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "Product ID"
              },
              "name": {
                "type": "string",
                "description": "Product name"
              }
            }
          }
        },
        "files": {
          "type": "array",
          "description": "Matching files",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "File ID"
              },
              "name": {
                "type": "string",
                "description": "File name"
              }
            }
          }
        }
      }
    }
  }
}

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_search