Demerzels-lab PCO CLI - Planning Center Services
CLI for the Planning Center Services API. Used for Shadow's church work (FBC Gulfport).
Repository
https://github.com/rubysworld/pco-cli
Location
/Users/ruby/Projects/pco-cli/pco.ts
Running
tsx /Users/ruby/Projects/pco-cli/pco.ts <command>
Or create an alias:
alias pco="tsx /Users/ruby/Projects/pco-cli/pco.ts"
Authentication
Credentials stored in ~/.config/pco-cli/config.json
# 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
pco org get # Get org info
Service Types
pco service-types list # List all service types
pco st list # Alias
pco service-types get <id> # Get specific service type
Plans
# 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
pco items list --service-type <id> --plan <planId>
pco items get <itemId> --service-type <id> --plan <planId>
Scheduled People (Team Members)
pco scheduled list --service-type <id> --plan <planId>
People
pco people list
pco people list --search "John Doe"
pco people get <id>
Teams
pco teams list --service-type <id>
pco teams get <teamId> --service-type <id>
Songs
pco songs list
pco songs list --search "Amazing Grace"
pco songs get <id>
pco songs arrangements <songId>
Media
pco media list
pco media get <id>
Folders
pco folders list
pco folders get <id>
Series
pco series list
pco series get <id>
Tag Groups
pco tag-groups list
pco tag-groups tags <groupId>
Email Templates
pco email-templates list
Attachment Types
pco attachment-types list
Report Templates
pco report-templates list
Raw API
# 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
# 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?
pco scheduled list --service-type <id> --plan <planId> --table
Search for a Song
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