Freedcamp
About
This is a Model Context Protocol (MCP) server implementation for Freedcamp task management. It provides tools for creating, updating, and deleting tasks in Freedcamp projects.
Details
- Author
- gabeosx
- Downloads
- 281
- Categories
- Other, Project Management
Jump to
- Create tasks with title, description, priority, due date, and assignee.
- Update existing tasks, including status changes.
- Delete tasks from Freedcamp projects.
- List all tasks in the configured project.
- Environment variable support for credentials.
- Error handling and input validation.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FreedcampCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server via npx freedcamp-mcp or clone and build from source. Configure your Freedcamp API key, secret, and project ID as environment variables (FREEDCAMP_API_KEY, FREEDCAMP_API_SECRET, FREEDCAMP_PROJECT_ID) in a .env file or directly in the MCP client config. Then invoke the provided tools – freedcamp_add_task, freedcamp_update_task, or freedcamp_list_tasks – through your MCP client.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"freedcamp": {
"freedcamp": {
"command": "npx",
"args": [
"freedcamp-mcp"
],
"env": {
"FREEDCAMP_API_KEY": "your_api_key",
"FREEDCAMP_API_SECRET": "your_api_secret",
"FREEDCAMP_PROJECT_ID": "your_project_id"
}
}
}
}
}McpServers
{
"freedcamp": {
"command": "npx",
"args": [
"freedcamp-mcp"
],
"env": {
"FREEDCAMP_API_KEY": "your_api_key",
"FREEDCAMP_API_SECRET": "your_api_secret",
"FREEDCAMP_PROJECT_ID": "your_project_id"
}
}
}Freedcamp MCP Server
This is a Model Context Protocol (MCP) server implementation for Freedcamp task management. It provides tools for creating, updating, and deleting tasks in Freedcamp projects.
Features
- Create new tasks with title, description, priority, due date, and assignee
- Update existing tasks including status changes
- Delete tasks
- Environment variable support for credentials
- Error handling and validation
Prerequisites
- Node.js 17 or higher
- TypeScript
- Freedcamp account with API access
- API Key and Secret from Freedcamp
- Project ID from Freedcamp
Installation
1. Clone the repository:
git clone <repository-url>
cd freedcamp-mcp
2. Install dependencies:
npm install
3. Create a .env file in the root directory with your Freedcamp credentials:
FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id
Usage
Running the Server
First build the TypeScript code:
npm run build
Then start the server:
npm start
Running the Test Harness
The project includes a comprehensive test harness that verifies all MCP functionality:
npm test
The test harness performs the following checks:
1. Server initialization with proper protocol version
2. Tool listing and capability verification
3. Task creation with various parameters
4. Task updates including status changes
5. Task listing and verification
Available Tools
1. freedcamp_add_task
- Creates a new task in Freedcamp
- Parameters:
- title (required): Task title
- description (optional): Task description
- priority (optional): Task priority (0-3)
- due_date (optional): Task due date (YYYY-MM-DD)
- assigned_to_id (optional): User ID to assign the task to
2. freedcamp_update_task
- Updates an existing task
- Parameters:
- task_id (required): ID of the task to update
- title (optional): New task title
- description (optional): New task description
- priority (optional): New task priority (0-3)
- due_date (optional): New due date (YYYY-MM-DD)
- assigned_to_id (optional): New user ID to assign the task to
- status (optional): New task status (0=open, 1=completed, 2=closed)
3. freedcamp_list_tasks
- Lists all tasks in the configured Freedcamp project
- No parameters required (uses project ID from environment variables)
- Returns a list of tasks with their details
IDE Integration
The server can be run directly using npx without cloning the repository.
Cursor
1. Open (or create) .cursor/mcp.json in your project root.
2. Add your Freedcamp MCP server configuration:
{
"mcpServers": {
"freedcamp": {
"command": "npx",
"args": ["freedcamp-mcp"],
"env": {
"FREEDCAMP_API_KEY": "your_api_key",
"FREEDCAMP_API_SECRET": "your_api_secret",
"FREEDCAMP_PROJECT_ID": "your_project_id"
}
}
}
}
3. Restart Cursor or reload MCP servers.
Roo
1. Open (or create) your Roo MCP config file (commonly roo.mcp.json or similar).
2. Add your Freedcamp MCP server configuration:
{
"mcpServers": {
"Freedcamp": {
"transport": "stdio",
"command": "npx",
"args": ["freedcamp-mcp"],
"env": {
"FREEDCAMP_API_KEY": "your_api_key",
"FREEDCAMP_API_SECRET": "your_api_secret",
"FREEDCAMP_PROJECT_ID": "your_project_id"
},
"alwaysAllow": [
"freedcamp_add_task"
]
}
}
}
- You can use
"alwaysAllow"Mon May 19 15:39:23 EDT 2025Mon May 19 15:49:11 EDT 2025
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
