Prepare the server locally
Run this once before adding it to Claude Code.
uv pip install -r requirements.txtRegister it in Claude Code
claude mcp add -e "PCO_SECRET_KEY=${PCO_SECRET_KEY}" -e "PCO_APPLICATION_ID=${PCO_APPLICATION_ID}" pco-mcp -- /path/to/fastmcp run /path/to/services.pyReplace any placeholder paths in the command with the real path on your machine.
PCO_SECRET_KEYPCO_APPLICATION_IDMake your agent remember this setup
pco-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- PCO API Integration for accessing and managing church data
- FASTMCP middleware for LLM communication
- Natural language query support for data retrieval and manipulation
Environment Variables
PCO_SECRET_KEYrequiredYour Planning Center API keyPCO_APPLICATION_IDrequiredURL of the MCP serverTry it
Original README from jake-ccnh/pco-mcp
Planning Center Online API and MCP Server Integration
This project integrates the Planning Center Online (PCO) API with an MCP server to enable seamless interaction with a Large Language Model (LLM). The goal is to allow users to ask questions and retrieve data from Planning Center in a conversational manner.
Features
- PCO API Integration: Connects to Planning Center Online to access and manage data.
- FASTMCP Server: Acts as a middleware to handle requests and responses between the LLM and PCO API.
- LLM Query Support: Enables natural language queries to fetch and manipulate data from Planning Center.
Use Cases
- Retrieve information about services in Planning Center.
- Automate workflows by querying and updating data using natural language.
- Provide insights and analytics through conversational queries.
Getting Started
Prerequisites
- Access to the Planning Center API.
- Python environment
- MCP Client (i.e. Claude Desktop)
- API keys for authentication.
Installation
Clone this repository:
git clone https://github.com/your-repo/pco-mcp-integration.gitInstall dependencies:
uv pip install -r requirements.txtConfigure environment variables:
PCO_SECRET_KEY: Your Planning Center API key.PCO_APPLICATION_ID: URL of the MCP server.
Test the server:
fastmcp dev services.py
Usage
- Send a natural language query to the MCP server.
- The server processes the query and interacts with the PCO API.
- Receive a structured response or perform the requested action.
Add MCP server config
{
"mcpServers": {
"pco-services": {
"command": "/path/to/fastmcp",
"args": ["run", "/path/to/services.py"],
"env": {
"PCO_APPLICATION_ID": "PCO_CLIENT_ID",
"PCO_SECRET_KEY": "PCO_CLIENT_SECRET_KEY"
}
}
}
Future Work
It is intended to continue work on other areas of planning center.
Contributing
Contributions are welcome! Please submit a pull request or open an issue for any suggestions or improvements.
License
This project is licensed under the MIT License.