pipedrive_list_deals

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

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

View all deals in your pipeline. Returns deal IDs, titles, values, stages, and owners. Use pipedrive_get_deal for full details on a specific deal.

Parameters

NameTypeRequiredDescription
_apiKeystringyesPipedrive API token
statusstringnoFilter by status: open, won, lost, deleted, all_not_deleted (default: all_not_deleted)
startnumbernoPagination start (default 0)
limitnumbernoNumber 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_deals","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_deals', {
  "_apiKey": "your-pipedrive-api-key"
});

More examples

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

Response shape

FieldTypeDescription
successbooleanWhether the request succeeded
dataarrayList of deals
additional_dataobjectPagination and metadata
Full JSON Schema
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request succeeded"
    },
    "data": {
      "type": "array",
      "description": "List of deals",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Deal ID"
          },
          "title": {
            "type": "string",
            "description": "Deal title"
          },
          "value": {
            "type": "number",
            "description": "Deal value"
          },
          "stage_id": {
            "type": "number",
            "description": "Pipeline stage ID"
          },
          "status": {
            "type": "string",
            "description": "Deal status"
          },
          "owner_id": {
            "type": "number",
            "description": "Deal owner 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.

Regenerated from source · build September 22, 2026