@mackenly/planningcenterkit is a fully typed, zero-dependency TypeScript client for every Planning Center API: People, Services, Check-Ins, Groups, Giving, Calendar, Registrations, Publishing, Current, Webhooks, and the API product.
import { PlanningCenter } from '@mackenly/planningcenterkit';
const pco = new PlanningCenter({
auth: { applicationId: process.env.PCO_APP_ID!, secret: process.env.PCO_SECRET! },
});
for await (const person of pco.people.people.where('status', 'active').order('last_name').all()) {
console.log(person.attributes.name); // string | null
}Install
npm i @mackenly/planningcenterkityarn add @mackenly/planningcenterkitpnpm add @mackenly/planningcenterkitbun add @mackenly/planningcenterkitRuns on Node.js 22+, Bun, Deno, Cloudflare Workers, Vercel, and any runtime with fetch, AbortSignal, and WebCrypto.
Why Planning Center Kit
- Every product, every resource. All 11 Planning Center products are generated from Planning Center’s published API documentation, so every resource, edge, include,
wherefield,orderfield, filter, and action is there. - Types for everything. Attribute types, create and update payloads, valid query names, and the resources you read from
includedare typed and autocompleted. Typos fail at compile time. - Names match Planning Center’s docs. Edges and attributes are
snake_caseexactly as in Planning Center’s reference. - Handles the hard parts. Automatic pagination, rate limiting from Planning Center’s headers,
Retry-After, retries with backoff, timeouts, andAbortSignalsupport. - OAuth done right. Automatic token refresh with rotating refresh tokens, an
onTokenRefreshhook to persist them, and helpers for the authorization flow with PKCE. - Webhooks. Constant-time signature verification with WebCrypto and typed event parsing.
- Zero dependencies. ESM and CommonJS builds, tree-shakeable per-product imports, and npm packages published with provenance.
Where to go next
Getting started
Install, get credentials, and make your first queries and writes.
Querying
Filter, include, sort, paginate, and follow nested resources.
Authentication
Personal access tokens and OAuth with PKCE and token rotation.
Reference
Every product and resource: client paths, attributes, query options, and writes.
For AI agents
This site publishes itself for coding agents:
/llms.txtindexes every page’s Markdown version, and every page URL answersAccept: text/markdown.- A remote MCP server at
https://planningcenterkit.mackenly.com/mcp(Streamable HTTP, no key) serveslist_pagesandget_page. - Agent Skills for using the client, receiving webhooks, and running the OAuth flow are listed at
/.well-known/agent-skills/index.json.
The npm package also ships AGENTS.md and llms.txt for agents working in your project.