Skip to main content
Glama
Planning Center Online MCP Server

Planning Center Online MCP Server

by tracsoftllc

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 build

2. 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 start

4. 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/mcp

Available Tools

People (/people/v2)

Tool

Description

pco_list_people

Search/list people with filters (name, status, gender, child)

pco_get_person

Get full person record with emails, phones, addresses

pco_create_person

Create a new person record

pco_update_person

Update an existing person (sparse update)

pco_list_person_emails

List email addresses for a person

pco_list_person_phone_numbers

List phone numbers for a person

pco_list_households

List households

pco_list_people_lists

List smart lists (saved filters)

Services (/services/v2)

Tool

Description

pco_list_service_types

List all service types

pco_list_plans

List plans for a service type (filter: future/past)

pco_get_plan

Get full plan details

pco_list_songs

List/search song library

pco_list_teams

List teams for a service type

pco_list_series

List sermon series for a service type

Giving (/giving/v2)

Tool

Description

pco_list_donations

List donations (filter by date, method, status)

pco_get_donation

Get donation details

pco_list_funds

List giving funds

pco_list_donation_batches

List donation batches

Groups (/groups/v2)

Tool

Description

pco_list_groups

List/search groups

pco_get_group

Get group details

pco_list_group_members

List group members/leaders

pco_list_group_types

List group types

Calendar (/calendar/v2)

Tool

Description

pco_list_calendar_events

List events (filter: approved/pending/future/past)

pco_get_calendar_event

Get event details with instances

pco_list_event_instances

List occurrences of a calendar event

pco_list_calendar_resources

List facility resources/rooms

Check-Ins (/check_ins/v2)

Tool

Description

pco_list_checkins

List check-in records (filter by date)

pco_list_checkin_events

List check-in events

pco_list_checkin_locations

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 clean

Environment Variables

Variable

Required

Description

PCO_APP_ID

✅

Planning Center Application ID

PCO_SECRET

✅

Planning Center Secret

TRANSPORT

No

Set to http for HTTP mode (default: stdio)

PORT

No

HTTP port (default: 3000, HTTP mode only)

API Reference

Available Tools

29 tools
pco_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 EventA
Read-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 DonationA
Read-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 GroupA
Read-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 PersonA
Read-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 PlanA
Read-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 EventsA
Read-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/RoomsA
Read-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 EventsB
Read-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 LocationsA
Read-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-InsA
Read-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 BatchesB
Read-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 DonationsB
Read-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 InstancesA
Read-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 FundsA
Read-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 MembersA
Read-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 GroupsA
Read-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 TypesB
Read-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 HouseholdsB
Read-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 PeopleA
Read-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 ListsA
Read-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 EmailsA
Read-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 NumbersA
Read-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 PlansA
Read-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 SeriesA
Read-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 TypesA
Read-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 SongsA
Read-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 TeamsA
Read-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 PersonA
Idempotent

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

    A3.8/5.0

    Scored across 29 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    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.

      https://mcp.paidnice.com/mcp

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Integrates 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.
      11
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      56
      34 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access Planning Center Online data including worship plans, song library, teams, and volunteer information through natural language queries and direct tools.
      1
      MIT