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.

Security Scan

The skill's instructions match a Planning Center CLI, but it relies on a local repo and local credential files while declaring no install steps or required credentials — the pieces are inconsistent and could cause accidental exposure of local API credentials or simply not work for other users.

Purpose & Capability

The SKILL.md documents a PCO CLI (commands, auth flow, repo URL) which is coherent with the name, but the skill bundle contains no code or install spec. It assumes a local repository path (/Users/ruby/Projects/pco-cli/pco.ts) and that 'tsx' is available. A user installing this skill would not get a runnable CLI from the skill itself — the skill only documents how to run a locally present tool. That mismatch (claims to provide CLI usage but doesn't include or install the tool) is a coherence problem.

Instruction Scope

Instructions explicitly reference absolute local paths and a local config file (~/.config/pco-cli/config.json) and show commands (pco auth status, pco auth setup) that will read or write local credential files. The SKILL.md therefore instructs actions that touch user-local files and credentials, but the skill metadata does not declare those files or any required credentials. This could cause an agent to access secrets on disk if it follows these instructions.

Install Mechanism

There is no install specification (instruction-only). That is low-risk from an automatic-install perspective, but it also explains why the SKILL.md points at an external local repo rather than providing an install — which is a usability/coherence issue rather than an installation risk.

Credentials

The skill declares no required environment variables or primary credential, yet the instructions refer to credentials stored in ~/.config/pco-cli/config.json and an interactive 'pco auth setup' flow. Requesting no declared credentials while instructing access to a local credential store is proportionally odd and should be clarified: a legitimate PCO CLI needs API credentials (Planning Center access token/secret), but the skill does not state where they come from or whether the agent should access them.

Persistence & Privilege

The skill does not request always: true and has no install actions that would persist or modify other skills or system-wide settings. There is no evidence it demands elevated persistence or cross-skill configuration changes.

What to consider before installing

This skill is an instruction-only doc for running a local PCO CLI — it does not provide the CLI or an install method. Before installing or enabling it: (1) confirm you (or the agent environment) actually have the referenced repository and tsx available at the specified path; (2) locate ~/.config/pco-cli/config.json and verify what credentials it contains — the agent's following these instructions could read that file; (3) prefer a skill that declares required credentials (or includes an install) so you know what is needed and what will be accessed; (4) if you don't have the repo or don't want an agent to access local credential files, do not enable this skill. If you want this functionality, ask the skill author to include an install spec, document required env vars, or avoid hard-coded local paths.

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