pco

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