maverick-pipedrive-mcp

by maverick

Install this Skill

curl -fsSL -o maverick-pipedrive-mcp.zip https://skill.seembox.com/api/v1/skills/maverick-pipedrive-mcp/download && unzip maverick-pipedrive-mcp.zip

Download maverick-pipedrive-mcp.zip

SKILL.md About

---
name: maverick-pipedrive-mcp
description: Search, read, and update Pipedrive deals, contacts, organizations, activities, pipelines, and sales workflows via Pipedrive's hosted MCP server (https://mcp.pipedrive.com/mcp). Use when the user asks about Pipedrive deals, people, organizations, activities, or pipeline state.
metadata:
  {
    "openclaw":
      {
        "emoji": "💼",
        "requires":
          {
            "bins": ["mcporter", "jq", "flock", "shasum"],
            "env":
              [
                "MAVERICK_PIPEDRIVE_MCP_REFRESH_TOKEN",
                "MAVERICK_PIPEDRIVE_MCP_CLIENT_ID",
                "MAVERICK_PIPEDRIVE_MCP_ACCESS_TOKEN",
              ],
          },
        "primaryEnv": "MAVERICK_PIPEDRIVE_MCP_REFRESH_TOKEN",
        "install":
          [
            {
              "id": "node",
              "kind": "node",
              "package": "mcporter",
              "bins": ["mcporter"],
              "label": "Install mcporter (node)",
            },
          ],
      },
  }
---

# Pipedrive

## Quick start

Always invoke through `bash {baseDir}/scripts/invoke.sh` — never call `mcporter` directly. The wrapper seeds the OAuth vault from the env-supplied tokens when needed, then calls `mcporter`.

```sh
bash {baseDir}/scripts/invoke.sh list maverick-pipedrive --schema
```

For structured output (also surfaces transport errors as JSON envelopes — workaround for mcporter [#153](https://github.com/steipete/mcporter/issues/153)):

```sh
bash {baseDir}/scripts/invoke.sh call --output json maverick-pipedrive.TOOL_NAME key=value | jq '.result.content'
```

## Safety

Write operations that create records, update properties, change deal stages, mark activities done, create notes, or delete data modify Pipedrive CRM state visible to the connected account. Confirm clear user intent before invoking write tools — search and read tools are safe to call freely while exploring. Search deals, people, organizations, and activities before assuming IDs, and read current deal stage, owner, value, and activity history before updating.

## Authentication

Tokens are provisioned and rotated automatically. If a call returns HTTP 401 that doesn't recover within a few seconds, the OAuth grant has been revoked — re-authorize the integration to refresh credentials.

## Data flow

Tool calls travel to Pipedrive's hosted MCP service at `https://mcp.pipedrive.com/mcp` over HTTPS, authenticated via OAuth. Pipedrive sees the deal, person, organization, activity, pipeline, and sales-workflow data referenced by each call. Use this skill for Pipedrive-related work only; do not pass unrelated sensitive content through these tools.

## Dependencies

- **`mcporter`** ([github.com/steipete/mcporter](https://github.com/steipete/mcporter)) — MCP CLI used to invoke Pipedrive's hosted MCP server. Auto-installed via `npm install -g --ignore-scripts mcporter` if missing on PATH (see `install` spec in frontmatter). The install spec uses unpinned `mcporter` (npm `latest`); operators with strict supply-chain controls should override the install to pin a specific version (e.g. `mcporter@<version>`).
- **`jq`** ([stedolan.github.io/jq](https://stedolan.github.io/jq/)) — JSON processor used by the vault initializer. System dependency; install via your OS package manager (`apt install jq`, `brew install jq`, etc.).
- **`flock`** (part of [util-linux](https://github.com/util-linux/util-linux)) — file locking used to serialize concurrent vault writes. Available by default on Linux; on macOS install via `brew install flock`.
- **`shasum`** (Perl, ships with [`Digest::SHA`](https://metacpan.org/pod/Digest::SHA)) — computes the SHA-256 hashes used to derive the mcporter vault key and the provisioned-token marker. Preinstalled on macOS and on Debian/Ubuntu (incl. the deployed `cloudflare/sandbox` Ubuntu 22.04 image); on minimal Linux images install `perl-Digest-SHA`. The script invokes `shasum -a 256` rather than GNU `sha256sum` so it runs on stock macOS without `coreutils`.

_meta.json Metadata

{
  "ownerId": "kn734qkn0pkds34pv28ksc0p7h81ha6e",
  "publishedAt": 1778006912407,
  "slug": "maverick-pipedrive-mcp",
  "version": "1.0.0"
}