← Back to Skills Marketplace
byungkyu

Pipedrive

by byungkyu · GitHub ↗ · v1.2.2 · MIT-0
cross-platform ✓ Security Clean
17118
Downloads
7
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install pipedrive-api
Description
Pipedrive API integration with managed OAuth. Manage deals, persons, organizations, activities, and pipelines. Use this skill when users want to interact with Pipedrive CRM. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Pipedrive connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Pipedrive action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Pipedrive examples; they add no Pipedrive capability - Pipedrive is not an event source, a trigger cannot read Pipedrive data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install only if you trust Maton and the package sources, prefer OAuth over API keys, review any requested Pipedrive write or deletion before approving it, and treat triggers or destinations as persistent data flows that should go only to hosts you explicitly control or approve.
Capability Assessment
✓ Credentials
Network access, OAuth, the Maton gateway, and optional raw HTTP are proportionate to a managed API integration; the raw API-key fallback includes explicit handling limits and is reserved for environments where the CLI cannot be installed.
ℹ Install Mechanism
Installation uses pinned Maton CLI/SDK packages via npm, Homebrew, or pip, but the skill does not provide independent checksums or signatures for those package-manager artifacts.
✓ Instruction Scope
Instructions default to read/list calls, require explicit confirmation for connection creation, writes, deletions, function deploys, invocations, and trigger destinations, and treat external content as untrusted data.
ℹ Persistence & Privilege
OAuth/API credentials are stored in the OS credential store, and hosted functions/triggers/destinations can persist until deleted; the artifact discloses these behaviors and requires user approval and cleanup for high-impact cases.
ℹ Purpose & Capability
The skill can read and modify Pipedrive CRM data and documents hosted functions/triggers, but those capabilities match the stated Pipedrive integration purpose and are repeatedly scoped to user-approved accounts, endpoints, and actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install pipedrive-api
  3. After installation, invoke the skill by name or use /pipedrive-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.1
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.4
- Updated all API references and example URLs to use https://api.maton.ai instead of previous gateway domain. - Connection management instructions now use https://api.maton.ai endpoints. - Added section on security and requiring explicit user approval for all write operations. - Clarified the need to specify the connection with the Maton-Connection header if using multiple Pipedrive accounts. - Removed LICENSE.txt file from the package.
v1.0.3
- Added new clawdbot metadata block specifying required environment variable MATON_API_KEY and emoji. - No changes to functionality or code; documentation and API usage remain the same.
v1.0.2
- No changes detected in this version.
v1.0.1
- Added a note in the description recommending the use of the api-gateway skill for other third-party apps. - Updated all shell code examples to use Python scripts via the command line, replacing curl with Python's urllib.request for requests and response handling. - The rest of the documentation and API reference remains unchanged.
v1.0.0
- Migrated to a managed OAuth model via Maton, replacing direct API token storage. - Added new documentation describing API usage via gateway.maton.ai and connection management via ctrl.maton.ai. - Updated authentication requirements: all requests now require a Maton API key in the `Authorization` header. - Major documentation update: details for managing deals, persons, organizations, activities, notes, and pipelines with example API requests. - Removed shell script references and legacy quick reference; previous CLI tooling is no longer included. - Added a LICENSE.txt; removed old reference and script files.
Metadata
Slug pipedrive-api
Version 1.2.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 9
Frequently Asked Questions

What is Pipedrive?

Pipedrive API integration with managed OAuth. Manage deals, persons, organizations, activities, and pipelines. Use this skill when users want to interact with Pipedrive CRM. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Pipedrive connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Pipedrive action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Pipedrive examples; they add no Pipedrive capability - Pipedrive is not an event source, a trigger cannot read Pipedrive data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 17118 downloads so far.

How do I install Pipedrive?

Run "/install pipedrive-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Pipedrive free?

Yes, Pipedrive is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Pipedrive support?

Pipedrive is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Pipedrive?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.2.

💬 Comments