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

1. Clone this repository:

   git clone https://github.com/your-repo/pco-mcp-integration.git  
   

2. Install dependencies:

   uv pip install -r requirements.txt 
   

3. Configure environment variables:

   • PCO_SECRET_KEY: Your Planning Center API key.
   • PCO_APPLICATION_ID: URL of the MCP server.

4. Test the server:

   fastmcp dev services.py
   

Usage

1. Send a natural language query to the MCP server.
2. The server processes the query and interacts with the PCO API.
3. 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

• Planning Center API Documentation
• FastMCP
• pypco