PCO CLI - Planning Center Services

CLI tool for managing Planning Center Services data including plans, teams, songs, and scheduled people via the PCO Services API.

CLI for the Planning Center Services API. Used for Shadow's church work (FBC Gulfport).

Repository

https://github.com/rubysworld/pco-cli

Location

text

/Users/ruby/Projects/pco-cli/pco.ts

Running

bash

tsx /Users/ruby/Projects/pco-cli/pco.ts <command>

Or create an alias:

bash

alias pco="tsx /Users/ruby/Projects/pco-cli/pco.ts"

Authentication

Credentials stored in ~/.config/pco-cli/config.json

bash

# Check auth status
pco auth status

# Setup (interactive)
pco auth setup

# Logout
pco auth logout

Global Options

All list commands support:

• --json - Output as JSON (default)
• --table - Output as table
• --quiet - Output only IDs
• --limit <n> - Limit results (default: 25)
• --offset <n> - Offset results
• --all - Fetch all pages

Commands

Organization

bash

pco org get                    # Get org info

Service Types

bash

pco service-types list         # List all service types
pco st list                    # Alias
pco service-types get <id>     # Get specific service type

Plans

bash

# List plans (service-type required)
pco plans list --service-type <id>
pco plans list --service-type <id> --filter future
pco plans list --service-type <id> --filter past

# Get specific plan
pco plans get <planId> --service-type <id>
pco plans get <planId> --service-type <id> --include items,team_members

Filters: future, past, after, before, no_dates

Plan Items

bash

pco items list --service-type <id> --plan <planId>
pco items get <itemId> --service-type <id> --plan <planId>

Scheduled People (Team Members)

bash

pco scheduled list --service-type <id> --plan <planId>

People

bash

pco people list
pco people list --search "John Doe"
pco people get <id>

Teams

bash

pco teams list --service-type <id>
pco teams get <teamId> --service-type <id>

Songs

bash

pco songs list
pco songs list --search "Amazing Grace"
pco songs get <id>
pco songs arrangements <songId>

Media

bash

pco media list
pco media get <id>

Folders

bash

pco folders list
pco folders get <id>

Series

bash

pco series list
pco series get <id>

Tag Groups

bash

pco tag-groups list
pco tag-groups tags <groupId>

Email Templates

bash

pco email-templates list

Attachment Types

bash

pco attachment-types list

Report Templates

bash

pco report-templates list

Raw API

bash

# Direct API access
pco api GET /service_types
pco api POST /endpoint --data '{"key": "value"}'
pco api PATCH /endpoint --file data.json
pco api DELETE /endpoint

Common Workflows

Get This Sunday's Service Plan

bash

# 1. Find service type ID
pco st list --table

# 2. Get future plans
pco plans list --service-type <id> --filter future --limit 1

# 3. Get plan details with includes
pco plans get <planId> --service-type <id> --include items,team_members

Who's Scheduled This Week?

bash

pco scheduled list --service-type <id> --plan <planId> --table

Search for a Song

bash

pco songs list --search "Great Are You Lord"

Notes

• This is for PCO Services only (not People, Giving, etc.)
• API docs: https://developer.planning.center/docs/#/apps/services
• Context: Church work only — don't mix with Buape stuff

---

Updated: 2026-01-08