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

```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

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