🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί PCO CLI - Planning Center Services
πŸ¦€ ClawHub

PCO CLI - Planning Center Services

by @rubyrunsstuff

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

Versionv1.0.0
Downloads2,037
Stars⭐ 1
#legal#automation#communication
TERMINAL
clawhub install pco

πŸ“– About This Skill

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

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 - Limit results (default: 25)
  • --offset - 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      # Get specific service type

    Plans

    # List plans (service-type required)
pco plans list --service-type 
pco plans list --service-type  --filter future
pco plans list --service-type  --filter past
    Get specific plan
    
pco plans get  --service-type 
pco plans get  --service-type  --include items,team_members

    Filters: future, past, after, before, no_dates

    Plan Items

    pco items list --service-type  --plan 
pco items get  --service-type  --plan

    Scheduled People (Team Members)

    pco scheduled list --service-type  --plan

    People

    pco people list
pco people list --search "John Doe"
pco people get

    Teams

    pco teams list --service-type 
pco teams get  --service-type

    Songs

    pco songs list
pco songs list --search "Amazing Grace"
pco songs get 
pco songs arrangements

    Media

    pco media list
pco media get

    Folders

    pco folders list
pco folders get

    Series

    pco series list
pco series get

    Tag Groups

    pco tag-groups list
pco tag-groups tags

    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  --filter future --limit 1
    3. Get plan details with includes
    
pco plans get  --service-type  --include items,team_members

    Who's Scheduled This Week?

    pco scheduled list --service-type  --plan  --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*

    πŸ“‹ Tips & Best Practices

  • 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*