Planning Center Online MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Planning Center Online MCP Server What service plans are scheduled for next Sunday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Planning Center Online MCP Server
An MCP (Model Context Protocol) server for the Planning Center Online API. Enables AI assistants like Claude to interact with your PCO account across all major modules.
Covered Modules
Module | Tools |
People | List/search people, get person, create/update person, emails, phone numbers, households, lists |
Services | Service types, plans, songs, teams, series |
Giving | Donations, funds, batches |
Groups | Groups, group types, members |
Calendar | Events, event instances, resources/rooms |
Check-Ins | Check-ins, events, locations |
Related MCP server: Ploomes MCP Server
Authentication
Planning Center uses Personal Access Tokens for single-account access. Get yours at: https://api.planningcenteronline.com/oauth/applications
You'll receive an Application ID and Secret — set these as environment variables.
Setup
1. Build
npm install
npm run build2. Configure Claude Desktop (or Claude Code)
Add the following to your MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"planning-center": {
"command": "node",
"args": ["/path/to/planning-center-mcp-server/dist/index.js"],
"env": {
"PCO_APP_ID": "your_application_id",
"PCO_SECRET": "your_secret"
}
}
}
}3. Run (stdio mode, for Claude Desktop)
PCO_APP_ID=your_app_id PCO_SECRET=your_secret npm start4. Run (HTTP mode, for remote/multi-client)
PCO_APP_ID=your_app_id PCO_SECRET=your_secret TRANSPORT=http PORT=3000 npm start
# Server available at http://localhost:3000/mcpAvailable Tools
People (/people/v2)
Tool | Description |
| Search/list people with filters (name, status, gender, child) |
| Get full person record with emails, phones, addresses |
| Create a new person record |
| Update an existing person (sparse update) |
| List email addresses for a person |
| List phone numbers for a person |
| List households |
| List smart lists (saved filters) |
Services (/services/v2)
Tool | Description |
| List all service types |
| List plans for a service type (filter: future/past) |
| Get full plan details |
| List/search song library |
| List teams for a service type |
| List sermon series for a service type |
Giving (/giving/v2)
Tool | Description |
| List donations (filter by date, method, status) |
| Get donation details |
| List giving funds |
| List donation batches |
Groups (/groups/v2)
Tool | Description |
| List/search groups |
| Get group details |
| List group members/leaders |
| List group types |
Calendar (/calendar/v2)
Tool | Description |
| List events (filter: approved/pending/future/past) |
| Get event details with instances |
| List occurrences of a calendar event |
| List facility resources/rooms |
Check-Ins (/check_ins/v2)
Tool | Description |
| List check-in records (filter by date) |
| List check-in events |
| List locations for a check-in event |
Example Conversations
Once connected, you can ask Claude:
"Show me all active people added in the last month"
"What plans are scheduled for next Sunday?"
"List all donations received in January over $500"
"How many members does the Young Adults small group have?"
"What calendar events are coming up this week?"
"Show me the children's check-in locations"
Development
# Watch mode for development
npm run dev
# Clean build artifacts
npm run cleanEnvironment Variables
Variable | Required | Description |
| ✅ | Planning Center Application ID |
| ✅ | Planning Center Secret |
| No | Set to |
| No | HTTP port (default: 3000, HTTP mode only) |
API Reference
Available Tools
29 toolspco_create_personCreate PersonA
Create a new person record in Planning Center People.
Args:
first_name (string, required): First name
last_name (string, required): Last name
middle_name (string, optional): Middle name
birthdate (string, optional): Birthdate in YYYY-MM-DD format
gender (string, optional): Gender ('M' or 'F')
status (string, optional): Status ('active' or 'inactive', default: 'active')
child (boolean, optional): Whether this is a child record
medical_notes (string, optional): Medical notes
Returns: The newly created person record with its assigned ID. Error: Returns "Error: ..." if validation fails.
Inputs: first_name (required), last_name (required), middle_name, birthdate, +4 more.
pco_get_calendar_eventGet Calendar EventARead-onlyIdempotent
Get detailed information about a specific calendar event.
Args:
id (string): The event ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Full event record with name, approval status, description, visibility, and registration info. Error: Returns "Error: Resource not found" if the ID is invalid.
Inputs: id (required), response_format.
pco_get_donationGet DonationARead-onlyIdempotent
Get detailed information about a specific donation by ID.
Args:
id (string): The donation ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Full donation record including amount, payment details, fund designations, and dates. Error: Returns "Error: Resource not found" if the ID is invalid.
Inputs: id (required), response_format.
pco_get_groupGet GroupARead-onlyIdempotent
Get detailed information about a specific group by its ID.
Args:
id (string): The group ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Full group record including name, description, location, schedule, member count, and Church Center URL. Error: Returns "Error: Resource not found" if the ID is invalid.
Inputs: id (required), response_format.
pco_get_personGet PersonARead-onlyIdempotent
Get detailed information about a single person by their PCO ID.
Args:
id (string): The PCO person ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Full person record including all attributes (name, gender, status, birthdate, etc.). Error: Returns "Error: Resource not found" if the ID is invalid.
Inputs: id (required), response_format.
pco_get_planGet PlanARead-onlyIdempotent
Get detailed information about a specific plan in Planning Center Services.
Args:
service_type_id (string): The service type ID
plan_id (string): The plan ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Full plan details including title, dates, team assignments, items, and notes count. Error: Returns "Error: Resource not found" if IDs are invalid.
Inputs: service_type_id (required), plan_id (required), response_format.
pco_list_calendar_eventsList Calendar EventsARead-onlyIdempotent
List events in Planning Center Calendar.
Args:
filter (string, optional): Filter events — 'approved', 'pending', 'rejected', 'future', 'past'
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 events with name, approval status, description, and visibility. Error: Returns "Error: ..." if the request fails.
Inputs: filter, limit, offset, response_format.
pco_list_calendar_resourcesList Calendar Resources/RoomsARead-onlyIdempotent
List facility resources (rooms, equipment) in Planning Center Calendar.
Args:
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 resources with name, kind, description, and quantity. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_checkin_eventsList Check-In EventsBRead-onlyIdempotent
List events (attendance tracking sessions) in Planning Center Check-Ins.
Args:
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 check-in events with name, frequency, and enable settings. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_checkin_locationsList Check-In LocationsARead-onlyIdempotent
List locations (rooms) for a check-in event in Planning Center Check-Ins.
Args:
event_id (string): The check-in event ID (get this from pco_list_checkin_events)
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 locations with name, capacity, and check-in count. Error: Returns "Error: Resource not found" if the event ID is invalid.
Inputs: event_id (required), limit, offset, response_format.
pco_list_checkinsList Check-InsARead-onlyIdempotent
List check-in records in Planning Center Check-Ins.
Args:
where_created_after (string, optional): Filter check-ins created after this date (YYYY-MM-DD)
where_created_before (string, optional): Filter check-ins created before this date (YYYY-MM-DD)
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 check-in records with name, security code, kind, and timestamps. Error: Returns "Error: ..." if the request fails.
Inputs: where_created_after, where_created_before, limit, offset, +1 more.
pco_list_donation_batchesList Donation BatchesBRead-onlyIdempotent
List donation batches in Planning Center Giving.
Args:
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 batches with description, status, total, and commit date. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_donationsList DonationsBRead-onlyIdempotent
List donations in Planning Center Giving.
Args:
where_received_after (string, optional): Filter donations received after this date (YYYY-MM-DD)
where_received_before (string, optional): Filter donations received before this date (YYYY-MM-DD)
where_payment_method (string, optional): Filter by payment method (e.g., 'card', 'check', 'cash')
where_payment_status (string, optional): Filter by status (e.g., 'succeeded', 'pending', 'failed')
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 donations with amount, payment method, date, and status. Error: Returns "Error: ..." if the request fails.
Inputs: where_received_after, where_received_before, where_payment_method, where_payment_status, +3 more.
pco_list_event_instancesList Calendar Event InstancesARead-onlyIdempotent
List specific instances (occurrences) of a calendar event.
Args:
event_id (string): The calendar event ID (get this from pco_list_calendar_events)
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 event instances with start/end times and location. Error: Returns "Error: Resource not found" if the event ID is invalid.
Inputs: event_id (required), limit, offset, response_format.
pco_list_fundsList Giving FundsARead-onlyIdempotent
List giving funds in Planning Center Giving.
Args:
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 funds with name, ledger code, description, visibility, and default status. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_group_membersList Group MembersARead-onlyIdempotent
List members of a specific group in Planning Center Groups.
Args:
group_id (string): The group ID (get this from pco_list_groups)
filter (string, optional): Filter members — 'leader' for leaders only, 'member' for regular members
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 group members with their name, role, and join date. Error: Returns "Error: Resource not found" if the group ID is invalid.
Inputs: group_id (required), filter, limit, offset, +1 more.
pco_list_groupsList GroupsARead-onlyIdempotent
List groups in Planning Center Groups.
Args:
query (string, optional): Search groups by name
where_group_type_id (string, optional): Filter by group type ID
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 groups with name, description, location, schedule, and member count. Error: Returns "Error: ..." if the request fails.
Inputs: query, where_group_type_id, limit, offset, +1 more.
pco_list_group_typesList Group TypesBRead-onlyIdempotent
List group types in Planning Center Groups.
Group types categorize groups (e.g., "Small Groups", "Bible Studies", "Recovery").
Args:
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 group types with name and group count. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_householdsList HouseholdsBRead-onlyIdempotent
List households in Planning Center People.
Args:
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 households with name, member count, and primary contact. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_peopleList / Search PeopleARead-onlyIdempotent
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.
Inputs: query, where_first_name, where_last_name, where_status, +7 more.
pco_list_people_listsList People ListsARead-onlyIdempotent
List smart lists (saved filters) in Planning Center People.
Args:
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 PCO Lists with name, description, status, and total count. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_person_emailsList Person EmailsARead-onlyIdempotent
Get all email addresses for a specific person in PCO.
Args:
person_id (string): The PCO person ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: List of email addresses with location and primary status. Error: Returns "Error: Resource not found" if the person ID is invalid.
Inputs: person_id (required), response_format.
pco_list_person_phone_numbersList Person Phone NumbersARead-onlyIdempotent
Get all phone numbers for a specific person in PCO.
Args:
person_id (string): The PCO person ID
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: List of phone numbers with carrier, location, and primary status. Error: Returns "Error: Resource not found" if the person ID is invalid.
Inputs: person_id (required), response_format.
pco_list_plansList PlansARead-onlyIdempotent
List plans for a specific service type in Planning Center Services.
Args:
service_type_id (string): The service type ID (get this from pco_list_service_types)
filter (string, optional): Filter plans — 'future' (upcoming), 'past', 'no_dates', or 'undated'
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 plans with title, dates, people count, and items count. Error: Returns "Error: Resource not found" if service_type_id is invalid.
Inputs: service_type_id (required), filter, limit, offset, +1 more.
pco_list_seriesList SeriesARead-onlyIdempotent
List sermon/service series in Planning Center Services.
Args:
service_type_id (string): The service type ID (get this from pco_list_service_types)
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 series with title, artwork, and plan count. Error: Returns "Error: Resource not found" if service_type_id is invalid.
Inputs: service_type_id (required), limit, offset, response_format.
pco_list_service_typesList Service TypesARead-onlyIdempotent
List all service types in Planning Center Services.
Service types represent different worship services (e.g., "Sunday Morning", "Wednesday Night").
Args:
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 service types with name, frequency, and creation date. Error: Returns "Error: ..." if the request fails.
Inputs: limit, offset, response_format.
pco_list_songsList SongsARead-onlyIdempotent
List songs in the Planning Center Services song library.
Args:
query (string, optional): Search songs by title
hidden (boolean, optional): Filter by hidden status (true = hidden, false = visible only)
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 songs with title, author, CCLI number, and last scheduled date. Error: Returns "Error: ..." if the request fails.
Inputs: query, hidden, limit, offset, +1 more.
pco_list_teamsList TeamsARead-onlyIdempotent
List teams for a specific service type in Planning Center Services.
Args:
service_type_id (string): The service type ID (get this from pco_list_service_types)
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 teams with name, schedule type, and whether it's a rehearsal team. Error: Returns "Error: Resource not found" if service_type_id is invalid.
Inputs: service_type_id (required), limit, offset, response_format.
pco_update_personUpdate PersonAIdempotent
Update an existing person record in Planning Center People.
Only the fields you provide will be updated (sparse update / PATCH semantics).
Args:
id (string): PCO person ID to update
first_name (string, optional): Updated first name
last_name (string, optional): Updated last name
middle_name (string, optional): Updated middle name
birthdate (string, optional): Updated birthdate in YYYY-MM-DD format
gender (string, optional): Updated gender ('M' or 'F')
status (string, optional): Updated status ('active' or 'inactive')
medical_notes (string, optional): Updated medical notes
Returns: Confirmation and the updated person record. Error: Returns "Error: Resource not found" if the ID is invalid.
Inputs: id (required), first_name, last_name, middle_name, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Each tool has a clearly distinct purpose targeting specific resources and actions within the Planning Center ecosystem. For example, pco_get_person retrieves a single person, pco_list_people searches and lists people, and pco_create_person creates a new person, with no overlap in functionality. The tools are well-organized by domain (People, Groups, Giving, Services, Calendar, Check-Ins), making it easy for an agent to distinguish between them.
All tool names follow a consistent 'pco_verb_noun' pattern with snake_case throughout. Verbs like 'create', 'get', 'list', and 'update' are used predictably across resources (e.g., pco_create_person, pco_get_person, pco_list_people, pco_update_person). This uniformity enhances readability and reduces cognitive load for agents when selecting tools.
With 29 tools, the count is borderline high for a single server, though it covers multiple Planning Center modules (People, Groups, Giving, Services, Calendar, Check-Ins). While each tool serves a specific purpose, the sheer number might overwhelm agents or lead to inefficiencies in tool selection. A more modular approach with fewer tools per domain could improve manageability.
The tool set provides comprehensive coverage for read and list operations across all major Planning Center domains, with create and update for people. However, there are notable gaps in CRUD operations for other resources like groups, donations, and events (e.g., no pco_create_group or pco_update_donation). These omissions could limit agents' ability to perform full lifecycle management, though core workflows are well-supported.
Maintenance
Related MCP Connectors
Planning Center MCP server for ChatGPT, Claude and any AI agent: send scheduling emails, list unconfirmed volunteers, accept or decline a schedule request, complete a workflow step, snooze a workflow card, add a profile note, list first-time guests and search people in your own Planning Center account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Planning Center yourself; Cotlet does not store your password and you need no Planning Center API key. About the official Planning Center API: Planning Center has a full REST API for Calendar, Check-Ins, Giving, Groups, People and Services, and since August 2026 an official MCP server, but the MCP is mostly read-only (checked 22 Oct 2026). Its only writes are in People: notes on profiles and forms. Setup and FAQ: https://cotlet.dev/integrations/planning-center-api-mcp-server
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
Connect your First AI Employee workspace to review authorized business records, including contacts, tasks, calls, bookings, forms and reports. Prepare supported changes as an exact preview for approval before applying them. OAuth sign-in is required; available tools depend on account permissions, enabled products and access. Website: https://firstaiemployee.com/ . Setup: https://developer.firstaiemployee.com/mcp/
Accounts receivable automation for Xero and QuickBooks Online, inside your AI assistant. Ask Claude, ChatGPT or any MCP client for a receivables summary, find customers and invoices, read the email and SMS replies your customers sent, and see what Paidnice sent or skipped. Ask why a reminder, late fee or statement did or did not go out, and update a customer's contact people straight into your ledger. Secure OAuth sign-in. One connection covers every organisation you tick, with Read or Read and Write access.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIntegrates the Planning Center Online API with an MCP server to enable natural language interaction with church management data. It allows users to query service information, manage workflows, and retrieve data through conversational prompts.11MIT
- AlicenseAqualityDmaintenanceConnects AI agents to the Ploomes CRM REST API, exposing 56 tools for managing contacts, deals, tasks, pipelines, interactions, quotes, orders, products, fields, users, and account information.5634 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access Planning Center Online data including worship plans, song library, teams, and volunteer information through natural language queries and direct tools.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to the Planning Center People API, enabling natural language queries for people, households, background checks, and lists.MIT