Pipedrive MCP by usefulapi is an MCP server published by io.usefulapi, hosted at pipedrive.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 19 tools, including pipedrive_list_deals, pipedrive_get_deal, pipedrive_search_deals, pipedrive_list_persons, pipedrive_get_person.
Read deals, persons, organizations, activities and pipelines; create and update CRM records.
3,987 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List deals, optionally filtered by filter/owner/person/org/pipeline/stage/status and sorted. Pipedrive REST: GET /api/v2/deals.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| org_id | integer | Filter by linked organization id. |
| status | string | Filter by deal status — 'open', 'won', 'lost' or 'deleted'. |
| sort_by | string | Field to sort by — 'id', 'update_time' or 'add_time'. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| owner_id | integer | Filter by owner (user) id. |
| stage_id | integer | Filter by stage id. |
| filter_id | integer | Filter by a saved filter id. |
| person_id | integer | Filter by linked person id. |
| pipeline_id | integer | Filter by pipeline id. |
| sort_direction | string | Sort direction — 'asc' or 'desc'. |
{
"name": "pipedrive_list_deals",
"title": "List deals",
"description": "List deals, optionally filtered by filter/owner/person/org/pipeline/stage/status and sorted. Pipedrive REST: GET /api/v2/deals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked organization id."
},
"status": {
"enum": [
"open",
"won",
"lost",
"deleted"
],
"type": "string",
"description": "Filter by deal status — 'open', 'won', 'lost' or 'deleted'."
},
"sort_by": {
"enum": [
"id",
"update_time",
"add_time"
],
"type": "string",
"description": "Field to sort by — 'id', 'update_time' or 'add_time'."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by owner (user) id."
},
"stage_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by stage id."
},
"filter_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by a saved filter id."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked person id."
},
"pipeline_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by pipeline id."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc'."
}
}
},
"annotations": {
"title": "List deals",
"readOnlyHint": true
}
}Get a single deal by its id. Pipedrive REST: GET /api/v2/deals/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Deal id (required). |
{
"name": "pipedrive_get_deal",
"title": "Get deal",
"description": "Get a single deal by its id. Pipedrive REST: GET /api/v2/deals/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Deal id (required)."
}
}
},
"annotations": {
"title": "Get deal",
"readOnlyHint": true
}
}Search deals by term across selected fields. Pipedrive REST: GET /api/v2/deals/search.
| Parameter | Type | Description |
|---|---|---|
| term * | string | Search term (at least 2 characters, required). |
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| fields | string | Comma-separated fields to search — any of 'custom_fields', 'notes', 'title'. |
| status | string | Restrict to deals with this status — 'open', 'won' or 'lost'. |
| person_id | integer | Restrict to deals linked to this person id. |
| exact_match | boolean | If true, only exact matches (case-insensitive) are returned. |
| organization_id | integer | Restrict to deals linked to this organization id. |
{
"name": "pipedrive_search_deals",
"title": "Search deals",
"description": "Search deals by term across selected fields. Pipedrive REST: GET /api/v2/deals/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"term"
],
"properties": {
"term": {
"type": "string",
"minLength": 2,
"description": "Search term (at least 2 characters, required)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"fields": {
"type": "string",
"description": "Comma-separated fields to search — any of 'custom_fields', 'notes', 'title'."
},
"status": {
"enum": [
"open",
"won",
"lost"
],
"type": "string",
"description": "Restrict to deals with this status — 'open', 'won' or 'lost'."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restrict to deals linked to this person id."
},
"exact_match": {
"type": "boolean",
"description": "If true, only exact matches (case-insensitive) are returned."
},
"organization_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restrict to deals linked to this organization id."
}
}
},
"annotations": {
"title": "Search deals",
"readOnlyHint": true
}
}List persons (contacts), optionally filtered by filter/owner/org and sorted. Pipedrive REST: GET /api/v2/persons.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| org_id | integer | Filter by linked organization id. |
| sort_by | string | Field to sort by — 'id', 'update_time' or 'add_time'. |
| owner_id | integer | Filter by owner (user) id. |
| filter_id | integer | Filter by a saved filter id. |
| sort_direction | string | Sort direction — 'asc' or 'desc'. |
{
"name": "pipedrive_list_persons",
"title": "List persons",
"description": "List persons (contacts), optionally filtered by filter/owner/org and sorted. Pipedrive REST: GET /api/v2/persons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked organization id."
},
"sort_by": {
"enum": [
"id",
"update_time",
"add_time"
],
"type": "string",
"description": "Field to sort by — 'id', 'update_time' or 'add_time'."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by owner (user) id."
},
"filter_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by a saved filter id."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc'."
}
}
},
"annotations": {
"title": "List persons",
"readOnlyHint": true
}
}Get a single person (contact) by its id. Pipedrive REST: GET /api/v2/persons/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Person id (required). |
{
"name": "pipedrive_get_person",
"title": "Get person",
"description": "Get a single person (contact) by its id. Pipedrive REST: GET /api/v2/persons/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Person id (required)."
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true
}
}Search persons (contacts) by term across selected fields. Pipedrive REST: GET /api/v2/persons/search.
| Parameter | Type | Description |
|---|---|---|
| term * | string | Search term (at least 2 characters, required). |
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| fields | string | Comma-separated fields to search — any of 'name', 'email', 'phone', 'notes', 'custom_fields'. |
| exact_match | boolean | If true, only exact matches (case-insensitive) are returned. |
| organization_id | integer | Restrict to persons linked to this organization id. |
{
"name": "pipedrive_search_persons",
"title": "Search persons",
"description": "Search persons (contacts) by term across selected fields. Pipedrive REST: GET /api/v2/persons/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"term"
],
"properties": {
"term": {
"type": "string",
"minLength": 2,
"description": "Search term (at least 2 characters, required)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"fields": {
"type": "string",
"description": "Comma-separated fields to search — any of 'name', 'email', 'phone', 'notes', 'custom_fields'."
},
"exact_match": {
"type": "boolean",
"description": "If true, only exact matches (case-insensitive) are returned."
},
"organization_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restrict to persons linked to this organization id."
}
}
},
"annotations": {
"title": "Search persons",
"readOnlyHint": true
}
}List organizations, optionally filtered by filter/owner and sorted. Pipedrive REST: GET /api/v2/organizations.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| sort_by | string | Field to sort by — 'id', 'update_time' or 'add_time'. |
| owner_id | integer | Filter by owner (user) id. |
| filter_id | integer | Filter by a saved filter id. |
| sort_direction | string | Sort direction — 'asc' or 'desc'. |
{
"name": "pipedrive_list_organizations",
"title": "List organizations",
"description": "List organizations, optionally filtered by filter/owner and sorted. Pipedrive REST: GET /api/v2/organizations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"sort_by": {
"enum": [
"id",
"update_time",
"add_time"
],
"type": "string",
"description": "Field to sort by — 'id', 'update_time' or 'add_time'."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by owner (user) id."
},
"filter_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by a saved filter id."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc'."
}
}
},
"annotations": {
"title": "List organizations",
"readOnlyHint": true
}
}Get a single organization by its id. Pipedrive REST: GET /api/v2/organizations/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Organization id (required). |
{
"name": "pipedrive_get_organization",
"title": "Get organization",
"description": "Get a single organization by its id. Pipedrive REST: GET /api/v2/organizations/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Organization id (required)."
}
}
},
"annotations": {
"title": "Get organization",
"readOnlyHint": true
}
}Search organizations by term across selected fields. Pipedrive REST: GET /api/v2/organizations/search.
| Parameter | Type | Description |
|---|---|---|
| term * | string | Search term (at least 2 characters, required). |
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| fields | string | Comma-separated fields to search — any of 'address', 'custom_fields', 'name', 'notes'. |
| exact_match | boolean | If true, only exact matches (case-insensitive) are returned. |
{
"name": "pipedrive_search_organizations",
"title": "Search organizations",
"description": "Search organizations by term across selected fields. Pipedrive REST: GET /api/v2/organizations/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"term"
],
"properties": {
"term": {
"type": "string",
"minLength": 2,
"description": "Search term (at least 2 characters, required)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"fields": {
"type": "string",
"description": "Comma-separated fields to search — any of 'address', 'custom_fields', 'name', 'notes'."
},
"exact_match": {
"type": "boolean",
"description": "If true, only exact matches (case-insensitive) are returned."
}
}
},
"annotations": {
"title": "Search organizations",
"readOnlyHint": true
}
}List activities (tasks/events), optionally filtered by filter/owner/deal/person/org/done/updated_since. Pipedrive REST: GET /api/v2/activities.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | Filter by completion — true for done, false for not done. |
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| org_id | integer | Filter by linked organization id. |
| deal_id | integer | Filter by linked deal id. |
| owner_id | integer | Filter by owner (user) id. |
| filter_id | integer | Filter by a saved filter id. |
| person_id | integer | Filter by linked person id. |
| updated_since | string | Only activities updated after this RFC 3339 timestamp, e.g. '2024-01-01T00:00:00Z'. |
{
"name": "pipedrive_list_activities",
"title": "List activities",
"description": "List activities (tasks/events), optionally filtered by filter/owner/deal/person/org/done/updated_since. Pipedrive REST: GET /api/v2/activities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"done": {
"type": "boolean",
"description": "Filter by completion — true for done, false for not done."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked organization id."
},
"deal_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked deal id."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by owner (user) id."
},
"filter_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by a saved filter id."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked person id."
},
"updated_since": {
"type": "string",
"description": "Only activities updated after this RFC 3339 timestamp, e.g. '2024-01-01T00:00:00Z'."
}
}
},
"annotations": {
"title": "List activities",
"readOnlyHint": true
}
}List all pipelines. Pipedrive REST: GET /api/v2/pipelines.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| sort_by | string | Field to sort by — 'id', 'update_time' or 'add_time'. |
| sort_direction | string | Sort direction — 'asc' or 'desc'. |
{
"name": "pipedrive_list_pipelines",
"title": "List pipelines",
"description": "List all pipelines. Pipedrive REST: GET /api/v2/pipelines.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"sort_by": {
"enum": [
"id",
"update_time",
"add_time"
],
"type": "string",
"description": "Field to sort by — 'id', 'update_time' or 'add_time'."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc'."
}
}
},
"annotations": {
"title": "List pipelines",
"readOnlyHint": true
}
}List stages, optionally restricted to a single pipeline. Pipedrive REST: GET /api/v2/stages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| pipeline_id | integer | Restrict to stages of this pipeline id. |
{
"name": "pipedrive_list_stages",
"title": "List stages",
"description": "List stages, optionally restricted to a single pipeline. Pipedrive REST: GET /api/v2/stages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"pipeline_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Restrict to stages of this pipeline id."
}
}
},
"annotations": {
"title": "List stages",
"readOnlyHint": true
}
}Global search across multiple item types (deals, persons, organizations, products, leads, files, etc.). Pipedrive REST: GET /api/v2/itemSearch.
| Parameter | Type | Description |
|---|---|---|
| term * | string | Search term (at least 2 characters, required). |
| limit | integer | Max results to return (1–500, default 100). |
| cursor | string | Opaque pagination cursor from a previous response's `next_cursor`. |
| fields | string | Comma-separated fields to search within (depends on item types). |
| item_types | string | Comma-separated item types to search — any of 'deal', 'person', 'organization', 'product', 'lead', 'file', 'mail_attachment', 'project'. |
| exact_match | boolean | If true, only exact matches (case-insensitive) are returned. |
| search_for_related_items | boolean | If true, also return items related to the matches (e.g. deals of a matched person). |
{
"name": "pipedrive_search_items",
"title": "Search items",
"description": "Global search across multiple item types (deals, persons, organizations, products, leads, files, etc.). Pipedrive REST: GET /api/v2/itemSearch.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"term"
],
"properties": {
"term": {
"type": "string",
"minLength": 2,
"description": "Search term (at least 2 characters, required)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max results to return (1–500, default 100)."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response's `next_cursor`."
},
"fields": {
"type": "string",
"description": "Comma-separated fields to search within (depends on item types)."
},
"item_types": {
"type": "string",
"description": "Comma-separated item types to search — any of 'deal', 'person', 'organization', 'product', 'lead', 'file', 'mail_attachment', 'project'."
},
"exact_match": {
"type": "boolean",
"description": "If true, only exact matches (case-insensitive) are returned."
},
"search_for_related_items": {
"type": "boolean",
"description": "If true, also return items related to the matches (e.g. deals of a matched person)."
}
}
},
"annotations": {
"title": "Search items",
"readOnlyHint": true
}
}Get the authenticated user's profile (name, email, company, locale, timezone). Pipedrive REST: GET /api/v1/users/me.
No parameters.
{
"name": "pipedrive_get_current_user",
"title": "Get current user",
"description": "Get the authenticated user's profile (name, email, company, locale, timezone). Pipedrive REST: GET /api/v1/users/me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get current user",
"readOnlyHint": true
}
}List notes, optionally filtered by user/deal/person/org/lead. Uses v1 (v2 has no notes endpoint) with start+limit pagination. Pipedrive REST: GET /api/v1/notes.
| Parameter | Type | Description |
|---|---|---|
| sort | string | Sort expression, e.g. 'add_time DESC'. |
| limit | integer | Max results to return (v1 limit). |
| start | integer | Pagination offset (v1 start; default 0). |
| org_id | integer | Filter by linked organization id. |
| deal_id | integer | Filter by linked deal id. |
| lead_id | string | Filter by linked lead id (a UUID string). |
| user_id | integer | Filter by the note author (user) id. |
| person_id | integer | Filter by linked person id. |
{
"name": "pipedrive_list_notes",
"title": "List notes",
"description": "List notes, optionally filtered by user/deal/person/org/lead. Uses v1 (v2 has no notes endpoint) with start+limit pagination. Pipedrive REST: GET /api/v1/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort expression, e.g. 'add_time DESC'."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Max results to return (v1 limit)."
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Pagination offset (v1 start; default 0)."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked organization id."
},
"deal_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked deal id."
},
"lead_id": {
"type": "string",
"description": "Filter by linked lead id (a UUID string)."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by the note author (user) id."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by linked person id."
}
}
},
"annotations": {
"title": "List notes",
"readOnlyHint": true
}
}Create a new deal. `title` is required; link it to a person/org/pipeline/stage/owner as needed. Pipedrive REST: POST /api/v2/deals.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Deal title (required). |
| value | number | Deal monetary value. |
| org_id | integer | Link to this organization id. |
| status | string | Deal status — 'open' (default), 'won' or 'lost'. |
| currency | string | Currency code for `value`, e.g. 'USD'. |
| owner_id | integer | Assign to this owner (user) id. |
| stage_id | integer | Place in this stage id. |
| person_id | integer | Link to this person id. |
| visible_to | integer | Visibility group id (Pipedrive visibility setting). |
| pipeline_id | integer | Place in this pipeline id. |
| expected_close_date | string | Expected close date, yyyy-mm-dd. |
{
"name": "pipedrive_create_deal",
"title": "Create deal",
"description": "Create a new deal. `title` is required; link it to a person/org/pipeline/stage/owner as needed. Pipedrive REST: POST /api/v2/deals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Deal title (required)."
},
"value": {
"type": "number",
"description": "Deal monetary value."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this organization id."
},
"status": {
"enum": [
"open",
"won",
"lost"
],
"type": "string",
"description": "Deal status — 'open' (default), 'won' or 'lost'."
},
"currency": {
"type": "string",
"description": "Currency code for `value`, e.g. 'USD'."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Assign to this owner (user) id."
},
"stage_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Place in this stage id."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this person id."
},
"visible_to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Visibility group id (Pipedrive visibility setting)."
},
"pipeline_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Place in this pipeline id."
},
"expected_close_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Expected close date, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Create deal",
"destructiveHint": true
}
}Create a new person (contact). `name` is required; `email`/`phone` are convenience strings mapped to Pipedrive's structured emails/phones arrays. Pipedrive REST: POST /api/v2/persons.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Person full name (required). |
| string | Primary email address (mapped to the emails array). | |
| phone | string | Primary phone number (mapped to the phones array). |
| org_id | integer | Link to this organization id. |
| owner_id | integer | Assign to this owner (user) id. |
| visible_to | integer | Visibility group id (Pipedrive visibility setting). |
{
"name": "pipedrive_create_person",
"title": "Create person",
"description": "Create a new person (contact). `name` is required; `email`/`phone` are convenience strings mapped to Pipedrive's structured emails/phones arrays. Pipedrive REST: POST /api/v2/persons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Person full name (required)."
},
"email": {
"type": "string",
"description": "Primary email address (mapped to the emails array)."
},
"phone": {
"type": "string",
"description": "Primary phone number (mapped to the phones array)."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this organization id."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Assign to this owner (user) id."
},
"visible_to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Visibility group id (Pipedrive visibility setting)."
}
}
},
"annotations": {
"title": "Create person",
"destructiveHint": true
}
}Create a new activity (task/event). `subject` is required; link it to a deal/person/org and set type/date/time as needed. Pipedrive REST: POST /api/v2/activities.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | Whether the activity is already marked done. |
| note | string | Free-text note attached to the activity. |
| type | string | Activity type key, e.g. 'call', 'meeting', 'task', 'email'. |
| org_id | integer | Link to this organization id. |
| deal_id | integer | Link to this deal id. |
| subject * | string | Activity subject/title (required). |
| due_date | string | Due date, yyyy-mm-dd. |
| due_time | string | Due time, HH:MM (24h). |
| duration | string | Duration, HH:MM. |
| owner_id | integer | Assign to this owner (user) id. |
| person_id | integer | Link to this person id. |
{
"name": "pipedrive_create_activity",
"title": "Create activity",
"description": "Create a new activity (task/event). `subject` is required; link it to a deal/person/org and set type/date/time as needed. Pipedrive REST: POST /api/v2/activities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subject"
],
"properties": {
"done": {
"type": "boolean",
"description": "Whether the activity is already marked done."
},
"note": {
"type": "string",
"description": "Free-text note attached to the activity."
},
"type": {
"type": "string",
"description": "Activity type key, e.g. 'call', 'meeting', 'task', 'email'."
},
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this organization id."
},
"deal_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this deal id."
},
"subject": {
"type": "string",
"minLength": 1,
"description": "Activity subject/title (required)."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Due date, yyyy-mm-dd."
},
"due_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Due time, HH:MM (24h)."
},
"duration": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Duration, HH:MM."
},
"owner_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Assign to this owner (user) id."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Link to this person id."
}
}
},
"annotations": {
"title": "Create activity",
"destructiveHint": true
}
}Add a note, linked to at least one of a deal/person/organization/lead. `content` is required (HTML or plain text). Uses v1 (v2 has no notes endpoint). Pipedrive REST: POST /api/v1/notes.
| Parameter | Type | Description |
|---|---|---|
| org_id | integer | Attach to this organization id. |
| content * | string | Note body — HTML or plain text (required). |
| deal_id | integer | Attach to this deal id. |
| lead_id | string | Attach to this lead id (a UUID string). |
| person_id | integer | Attach to this person id. |
{
"name": "pipedrive_add_note",
"title": "Add note",
"description": "Add a note, linked to at least one of a deal/person/organization/lead. `content` is required (HTML or plain text). Uses v1 (v2 has no notes endpoint). Pipedrive REST: POST /api/v1/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"content"
],
"properties": {
"org_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Attach to this organization id."
},
"content": {
"type": "string",
"minLength": 1,
"description": "Note body — HTML or plain text (required)."
},
"deal_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Attach to this deal id."
},
"lead_id": {
"type": "string",
"description": "Attach to this lead id (a UUID string)."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Attach to this person id."
}
}
},
"annotations": {
"title": "Add note",
"destructiveHint": true
}
}Tools for Pipedrive, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which open deals are in the negotiation stage, and what are they worth?"; "Show everything we have on Acme Ltd: contacts, deals and notes."; "Show our unfinished sales activities and their due dates.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Pipedrive data. Free plan: 50 tool calls per month. Run pipedrive_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run pipedrive_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run pipedrive_upgrade without a plan: it returns both plans, each with a payment link for the user to open. pipedrive_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.