ClawHub

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.

Audits

Pass
ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install 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

Updated: 2026-01-08