List / Search People
pco_list_peopleSearch and filter people in Planning Center People by name, status, gender, or age group to retrieve contact details and membership information.
Instructions
Search for and list people in Planning Center People (PCO).
Supports filtering by name, status, and more. Returns person records with attributes.
Args:
query (string, optional): Search by name (partial match on first or last name)
where_first_name (string, optional): Filter by exact first name
where_last_name (string, optional): Filter by exact last name
where_status (string, optional): Filter by membership status (e.g. 'active', 'inactive')
where_gender (string, optional): Filter by gender (e.g. 'M', 'F')
where_child (boolean, optional): Filter to only children (true) or adults (false)
include_emails (boolean, optional): Include email addresses in response
include_phone_numbers (boolean, optional): Include phone numbers in response
limit (number): Max results (1-100, default 25)
offset (number): Pagination offset (default 0)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: List of people with name, status, gender, birthdate, created/updated dates. Error: Returns "Error: ..." message if the request fails.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search by name (partial match) | |
| where_first_name | No | Filter by exact first name | |
| where_last_name | No | Filter by exact last name | |
| where_status | No | Filter by membership status | |
| where_gender | No | Filter by gender (M or F) | |
| where_child | No | Filter to children (true) or adults (false) | |
| include_emails | No | Include email addresses in response | |
| include_phone_numbers | No | Include phone numbers in response | |
| limit | No | Maximum number of results to return (1-100, default: 25) | |
| offset | No | Number of results to skip for pagination (default: 0) | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |