README.md
Integrates the Planning Center Online API with an MCP server
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.
Resources
Environment Variables
PCO_SECRET_KEYrequiredYour Planning Center API keyPCO_APPLICATION_IDrequiredURL of the MCP serverConfiguration
claude_desktop_config.json
{"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"}}}}Try it
→List all upcoming services in Planning Center.
→Retrieve information about the service scheduled for this Sunday.
→Update the service details for the upcoming worship event.
→Provide an overview of recent service data from Planning Center.