pipedrive-apiPipedrive 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).
Install via ClawdBot CLI:
clawdbot install byungkyu/pipedrive-apiAccess the Pipedrive API with managed OAuth authentication. Manage deals, persons, organizations, activities, pipelines, and more for sales CRM workflows.
# List deals
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/pipedrive/api/v1/deals')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFhttps://gateway.maton.ai/pipedrive/{native-api-path}Replace {native-api-path} with the actual Pipedrive API endpoint path. The gateway proxies requests to api.pipedrive.com and automatically injects your OAuth token.
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEYEnvironment Variable: Set your API key as MATON_API_KEY:
export MATON_API_KEY="YOUR_API_KEY"Manage your Pipedrive OAuth connections at https://ctrl.maton.ai.
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=pipedrive&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFpython <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'pipedrive'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFpython <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFResponse:
{
"connection": {
"connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
"status": "ACTIVE",
"creation_time": "2025-12-08T07:20:53.488460Z",
"last_updated_time": "2026-01-31T20:03:32.593153Z",
"url": "https://connect.maton.ai/?session_token=...",
"app": "pipedrive",
"metadata": {}
}
}Open the returned url in a browser to complete OAuth authorization.
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFIf you have multiple Pipedrive connections, specify which one to use with the Maton-Connection header:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/pipedrive/api/v1/deals')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFIf omitted, the gateway uses the default (oldest) active connection.
GET /pipedrive/api/v1/dealsQuery parameters:
status - Filter by status: open, won, lost, deleted, all_not_deletedfilter_id - Filter ID to usestage_id - Filter by stageuser_id - Filter by userstart - Pagination start (default 0)limit - Items per page (default 100)sort - Sort field and order (e.g., add_time DESC)Example:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/pipedrive/api/v1/deals?status=open&limit=50')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFGET /pipedrive/api/v1/deals/{id}POST /pipedrive/api/v1/deals
Content-Type: application/json
{
"title": "New Enterprise Deal",
"value": 50000,
"currency": "USD",
"person_id": 123,
"org_id": 456,
"stage_id": 1,
"expected_close_date": "2025-06-30"
}PUT /pipedrive/api/v1/deals/{id}
Content-Type: application/json
{
"title": "Updated Deal Title",
"value": 75000,
"status": "won"
}DELETE /pipedrive/api/v1/deals/{id}GET /pipedrive/api/v1/deals/search?term=enterpriseGET /pipedrive/api/v1/personsQuery parameters:
filter_id - Filter IDstart - Pagination startlimit - Items per pagesort - Sort field and orderGET /pipedrive/api/v1/persons/{id}POST /pipedrive/api/v1/persons
Content-Type: application/json
{
"name": "John Doe",
"email": ["john@example.com"],
"phone": ["+1234567890"],
"org_id": 456,
"visible_to": 3
}PUT /pipedrive/api/v1/persons/{id}
Content-Type: application/json
{
"name": "John Smith",
"email": ["john.smith@example.com"]
}DELETE /pipedrive/api/v1/persons/{id}GET /pipedrive/api/v1/persons/search?term=johnGET /pipedrive/api/v1/organizationsGET /pipedrive/api/v1/organizations/{id}POST /pipedrive/api/v1/organizations
Content-Type: application/json
{
"name": "Acme Corporation",
"address": "123 Main St, City, Country",
"visible_to": 3
}PUT /pipedrive/api/v1/organizations/{id}
Content-Type: application/json
{
"name": "Acme Corp International"
}DELETE /pipedrive/api/v1/organizations/{id}GET /pipedrive/api/v1/activitiesQuery parameters:
type - Activity type (e.g., call, meeting, task, email)done - Filter by completion (0 or 1)user_id - Filter by userstart_date - Filter by start dateend_date - Filter by end dateGET /pipedrive/api/v1/activities/{id}POST /pipedrive/api/v1/activities
Content-Type: application/json
{
"subject": "Follow-up call",
"type": "call",
"due_date": "2025-03-15",
"due_time": "14:00",
"duration": "00:30",
"deal_id": 789,
"person_id": 123,
"note": "Discuss contract terms"
}PUT /pipedrive/api/v1/activities/{id}
Content-Type: application/json
{
"done": 1,
"note": "Completed - customer agreed to terms"
}DELETE /pipedrive/api/v1/activities/{id}GET /pipedrive/api/v1/pipelinesGET /pipedrive/api/v1/pipelines/{id}GET /pipedrive/api/v1/stagesQuery parameters:
pipeline_id - Filter by pipelineGET /pipedrive/api/v1/stages/{id}GET /pipedrive/api/v1/notesQuery parameters:
deal_id - Filter by dealperson_id - Filter by personorg_id - Filter by organizationPOST /pipedrive/api/v1/notes
Content-Type: application/json
{
"content": "Meeting notes: Discussed pricing and timeline",
"deal_id": 789,
"pinned_to_deal_flag": 1
}GET /pipedrive/api/v1/usersGET /pipedrive/api/v1/users/meconst headers = {
'Authorization': `Bearer ${process.env.MATON_API_KEY}`
};
// List open deals
const deals = await fetch(
'https://gateway.maton.ai/pipedrive/api/v1/deals?status=open',
{ headers }
).then(r => r.json());
// Create a deal
await fetch(
'https://gateway.maton.ai/pipedrive/api/v1/deals',
{
method: 'POST',
headers: { ...headers, 'Content-Type': 'application/json' },
body: JSON.stringify({
title: 'New Deal',
value: 10000,
currency: 'USD'
})
}
);import os
import requests
headers = {'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
# List open deals
deals = requests.get(
'https://gateway.maton.ai/pipedrive/api/v1/deals',
headers=headers,
params={'status': 'open'}
).json()
# Create a deal
response = requests.post(
'https://gateway.maton.ai/pipedrive/api/v1/deals',
headers=headers,
json={
'title': 'New Deal',
'value': 10000,
'currency': 'USD'
}
)visible_to values: 1 (owner only), 3 (entire company), 5 (owner's visibility group), 7 (entire company and visibility group)open, won, lost, deletedstart and limit for paginationabc123_custom_field)curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsingjq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.| Status | Meaning |
|--------|---------|
| 400 | Missing Pipedrive connection |
| 401 | Invalid or missing Maton API key |
| 404 | Resource not found |
| 429 | Rate limited (10 req/sec per account) |
| 4xx/5xx | Passthrough error from Pipedrive API |
MATON_API_KEY environment variable is set:echo $MATON_API_KEYpython <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFpipedrive. For example:https://gateway.maton.ai/pipedrive/api/v1/dealshttps://gateway.maton.ai/api/v1/dealsGenerated Mar 1, 2026
Sales teams can use this skill to track deals through stages, update deal statuses, and forecast revenue. It enables real-time monitoring of open deals, setting expected close dates, and moving deals between pipeline stages to optimize sales workflows.
Businesses can manage contacts and organizations by creating, updating, and searching persons in Pipedrive. This helps maintain up-to-date customer records, segment contacts for marketing campaigns, and link deals to specific clients for better relationship management.
Teams can schedule and track activities related to deals and contacts, such as meetings, calls, and follow-ups. This ensures timely engagement with prospects, improves team collaboration, and helps prioritize tasks based on deal stages and deadlines.
Finance and sales departments can generate reports on deal values, win rates, and revenue trends by querying deals with filters like status and stage. This supports data-driven decision-making, performance analysis, and forecasting for business growth.
Companies with multiple Pipedrive accounts can use connection management to switch between different OAuth connections. This allows handling separate sales pipelines for different departments or clients, ensuring data isolation and tailored workflows.
This skill supports SaaS companies by automating CRM data syncing and deal tracking for recurring revenue models. It helps manage customer lifecycles, from onboarding to renewal, by integrating Pipedrive with other tools via the API gateway for scalable operations.
Agencies can use this skill to manage client projects and sales pipelines in Pipedrive, tracking deliverables and billing based on deal milestones. It enables efficient client reporting, resource allocation, and revenue tracking across multiple engagements.
Retail businesses can leverage this skill to sync sales data from online platforms into Pipedrive, managing customer deals and inventory-related activities. It aids in analyzing sales performance, forecasting demand, and personalizing customer interactions for increased conversions.
💬 Integration Tip
Ensure the MATON_API_KEY is securely set as an environment variable and use the Maton-Connection header for multiple Pipedrive accounts to avoid authentication issues.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.