AgentSkillsCN

Pco

Pco

SKILL.md

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

code
/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

Updated: 2026-01-08