freedcamp

This MCP server provides a comprehensive integration layer with the Freedcamp API, exposing project, task, user, comment, and file management capabilities through the MCP protocol. You can use the included tools to list and inspect projects, manage tasks with advanced filtering and subtask support, handle users and assignments, and work with comments and file attachments. The server is designed for scalable use via Docker, with health checks and isolated networking to protect credentials. As recommended in the workflow, start by retrieving projects and users (get_projects and get_users) to obtain IDs before performing operations that reference them. The API surface is exposed via the MCP endpoints and mirrored in the OpenAPI proxy and documentation available at the local Docker host.

Prerequisites:

• Docker and Docker Compose installed on your machine
• Freedcamp API credentials (API Key and optional API Secret)

Installation steps:

1. Clone the repository and navigate to the project folder:

git clone https://github.com/BluePointDigital/freedcamp-mcp-server.git
cd freedcamp-mcp-server

2. Create and configure environment variables (example):

cp env-example.sh .env
# Edit .env to add your Freedcamp credentials

3. Start the MCP server using Docker:

docker-compose up -d

4. Verify the services are running and accessible:

• MCP Server endpoint: http://localhost:8000/mcp/
• OpenAPI Proxy: http://localhost:8111
• API Documentation: http://localhost:8111/docs

Environment variables are required to authorize with Freedcamp (FREEDCAMP_API_KEY and optionally FREEDCAMP_API_SECRET). If you run into rate limits or authentication errors, recheck that the credentials are correct and that the API key has the necessary scopes. The docker-compose setup includes health checks and restart policies for reliability. For production deployments, consider using a dedicated environment file and secret management, and configure network isolation and proper port mapping. If you need to scale task processing, leverage the provided docker-compose scale options (e.g., --scale freedcamp-fastapi=3) as described in the deployment section.