Skip to main content
Glama
Planning Center MCP Server

Planning Center MCP Server

README.md
# Planning Center MCP server for ChatGPT and Claude

Planning Center has a public REST API and an official MCP server that is mostly read-only, according to the live Cotlet.dev page (checked 22 October 2026). Cotlet.dev adds a hosted connection with 12 workflow tools for People, Services and Check-Ins, including volunteer scheduling emails, schedule responses, workflow cards and profile notes.

## What you can ask

> List my pending and confirmed scheduling requests.

> Find the volunteers scheduled for this service plan.

> Draft scheduling emails for volunteers whose emails are still waiting, then ask before sending.

> List first-time guests from this week.

> Draft a People profile note and ask before saving it.

> List ready and snoozed workflow cards.

## Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.

### ChatGPT

Settings > Apps & Connectors > Create. Use `https://cotlet.dev/mcp/v1/connect` with OAuth.

### Claude

Settings > Connectors > Add custom connector. Use `https://cotlet.dev/mcp/v1/connect`.

### Claude Code

```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

### Cursor

Copy `.cursor/mcp.json` from this repo into your project:

```json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}
```

## Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Planning Center tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Clone this repository and run `python3 planning_center_agent.py serve` with `COTLET_API_KEY` set.

Or with Docker:

```bash
docker build -t planning-center-mcp .
docker run -i --rm -e COTLET_API_KEY planning-center-mcp
```

The local server exposes seven browser helper tools, distinct from the 12 hosted workflow tools described on the live page.

Local tools: `planning_center_guide`, `planning_center_status`, `planning_center_open`, `planning_center_read`, `planning_center_click`, `planning_center_type`, `planning_center_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

## Command line

Python 3.10+, nothing else to install. Run from this repo:

```bash
export COTLET_API_KEY="your-key"
python3 planning_center_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 planning_center_agent.py status    # is Planning Center ready in your Cotlet.dev account
python3 planning_center_agent.py guide     # Planning Center screens and sign-in link
python3 planning_center_agent.py read      # open Planning Center, read the page, close the browser
python3 planning_center_agent.py tools     # list Cotlet.dev tools
python3 planning_center_agent.py serve     # start the stdio MCP server (same as no argument)
```

## Questions from Planning Center users

**Does Planning Center have an official API or MCP server?**

Yes. The live Cotlet.dev page, checked 22 October 2026, describes a full REST API and a mostly read-only official MCP server. Consider the official connection for reading. Cotlet.dev adds scheduling emails, schedule responses and workflow-card actions.

**Which changes require approval?**

Scheduling emails, schedule responses, completing workflow steps and adding profile notes ask for approval by default. Approval settings can be changed per tool.

**Which permissions do I need?**

Your agent uses your signed-in permissions. Scheduling emails require a team leader role in Services; People notes require View / Create access to the note category.

**Does this cover Giving or donations?**

No. The hosted tools cover People, Services and Check-Ins. They do not read or change donations, funds or payments.

**Is this an official Planning Center integration?**

No. Cotlet.dev is independent and is not affiliated with Planning Center.

## Live integration

[Planning Center tools and connection guide](https://cotlet.dev/integrations/planning-center-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=planning-center)

---

More: https://cotlet.dev/integrations/planning-center-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=planning-center

Start free: https://cotlet.dev/signup?app=planning-center&utm_source=github&utm_medium=readme&utm_campaign=planning-center