Enhanced Freedcamp

You can run and use an MCP server that integrates Freedcamp to manage projects, tasks, users, and files from a single API surface. This server provides advanced filtering, complete CRUD operations, and configurable workflows to connect your client applications with Freedcamp data and actions.

How to use

Start by connecting your MCP client to the remote MCP endpoint. You will interact with the server to list and manage projects, tasks, users, comments, and files. Use the provided tools to fetch current data (such as projects and users) and then perform create, read, update, or delete operations as needed. Rely on the OpenAPI proxy for documentation and endpoint discovery to understand available operations, required fields, and response formats.

Important workflow guidance is available to help you perform operations reliably. Always retrieve current project and user data first to obtain IDs you will reference in subsequent requests. Use the OpenAPI docs for endpoint details, including available filters, pagination, and error handling.

How to install

Prerequisites: Docker, Docker Compose, and Freedcamp API credentials (API Key).

1. Create a working directory for the MCP server and obtain the deployment files.

2. Prepare environment variables with your Freedcamp credentials.

3. Start the services using Docker Compose.

4. Access the MCP API at http://localhost:8000/mcp/, the OpenAPI proxy at http://localhost:8111, and the API documentation at http://localhost:8111/docs.

Configuration

Create a .env file in your deployment directory containing your Freedcamp credentials. These values are used by the MCP server to authenticate with the Freedcamp API.

FREEDCAMP_API_KEY=your_api_key_here
FREEDCAMP_API_SECRET=your_api_secret_here  # Optional for some endpoints

Deployment notes

The server is designed to run in a containerized environment. You can monitor service health and logs to ensure reliability and performance.

docker-compose ps  # Check service health
docker-compose logs -f  # Monitor logs

Available tools

get_projects

List all projects with grouping and optional recent project tracking.

get_project_details

Fetch detailed information for a specific project, including users and capabilities.

create_project

Create a new project with specified details and initial team members.

update_project

Update project attributes and manage associated users.

delete_project

Remove a project and cascading related data as needed.

get_all_tasks

Retrieve tasks with advanced filtering, pagination, and ordering.

get_task_details

Obtain full information about a task, including comments and attachments.

create_task

Create a task with optional subtasks, attachments, and recurrence rules.

update_task

Modify task properties and custom fields.

delete_task

Delete a task with cascade handling for related data.

get_users

List all workspace users with complete profile data.

get_current_user

Return information about the currently authenticated user.

update_current_user

Manage the current user's profile, including email and password changes.

add_comment

Create comments with file attachments and HTML support.

update_comment

Edit existing comments with rich text support.

delete_comment

Remove comments and associated data.

get_file_details

Retrieve file metadata, URLs, and thumbnails.

delete_file

Delete files and perform cleanup.