https://github.com/agrublev/freedcamp-mcp

Last synced: about 1 month ago
JSON representation
Host: GitHub
URL: https://github.com/agrublev/freedcamp-mcp
Owner: agrublev
Created: 2026-05-28T09:43:37.000Z (about 2 months ago)
Default Branch: master
Last Pushed: 2026-05-28T11:22:19.000Z (about 2 months ago)
Last Synced: 2026-05-28T12:06:46.234Z (about 2 months ago)
Language: JavaScript
Size: 316 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
Awesome Lists containing this project

README

          # Freedcamp MCP Server

![](./ClaudeDesktop.png)

MCP Server for the [Freedcamp](https://freedcamp.com) API, enabling project management, task tracking, time logging, CRM, and more through Claude and other MCP clients.

## Setup

### API Credentials

1. Log in to your Freedcamp account

2. Go to **Settings → API** to generate your API key and secret

3. Set the environment variables:

```bash

export FREEDCAMP_API_KEY=your_api_key

export FREEDCAMP_API_SECRET=your_api_secret

```

### Usage with Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json

{

  "mcpServers": {

    "freedcamp": {

      "command": "npx",

      "args": ["-y", "freedcamp-mcp-server"],

      "env": {

        "FREEDCAMP_API_KEY": "",

        "FREEDCAMP_API_SECRET": ""

      }

    }

  }

}

```

### Usage with VS Code

Add to your User Settings (JSON) or `.vscode/mcp.json`:

```json

{

  "mcp": {

    "inputs": [

      { "type": "promptString", "id": "fc_key", "description": "Freedcamp API Key", "password": true },

      { "type": "promptString", "id": "fc_secret", "description": "Freedcamp API Secret", "password": true }

    ],

    "servers": {

      "freedcamp": {

        "command": "npx",

        "args": ["-y", "freedcamp-mcp-server"],

        "env": {

          "FREEDCAMP_API_KEY": "${input:fc_key}",

          "FREEDCAMP_API_SECRET": "${input:fc_secret}"

        }

      }

    }

  }

}

```

---

## Tools

All tools are prefixed with `fc_`.

### Projects

| Tool | Description |

|------|-------------|

| `fc_fetch_projects` | List all projects |

| `fc_fetch_project` | Get a single project (`project_id`) |

| `fc_fetch_recent_project_ids` | Get recently accessed project IDs |

| `fc_add_project` | Create a project (`project_name`, optional: `project_description`, `project_color`, `group_id`) |

| `fc_edit_project` | Edit a project (`project_id`, optional: `project_name`, `project_color`, `group_id`) |

| `fc_leave_project` | Leave a project (`membership_id`) |

| `fc_delete_project` | Delete a project (`project_id`) |

| `fc_add_favorite_project` | Add project to favorites (`project_id`) |

| `fc_delete_favorite_project` | Remove project from favorites (`project_id`) |

| `fc_fetch_overview` | Get project overview (`project_id`) |

### Tasks

| Tool | Description |

|------|-------------|

| `fc_fetch_task` | Get a task by ID (`task_id`) |

| `fc_fetch_tasks` | List tasks (`project_id`, optional: `limit`, `offset`, `filters`) |

| `fc_add_task` | Create a task (`title`, `project_id`, optional: `description`, `task_group_id`, `priority`, `assigned_to_id`, `due_date`, `status`) |

| `fc_update_task` | Update a task (`task_id`, optional: `title`, `description`, `status`, `priority`, `assigned_to_id`, `due_date`) |

| `fc_delete_task` | Delete a task (`task_id`) |

**Task filters** (passed inside `filters` object):

- `status`: array of `STATUS_NOT_STARTED`, `STATUS_COMPLETED`, `STATUS_IN_PROGRESS`, `STATUS_INVALID`, `STATUS_REVIEW`

- `assigned_to_id`: array of user IDs

- `due_date_from` / `due_date_to`: date strings

- `created_date_from` / `created_date_to`: date strings

### Lists

| Tool | Description |

|------|-------------|

| `fc_fetch_lists` | Get lists for a project (`project_id`, optional: `app_id`) |

| `fc_add_list` | Create a list (`project_id`, `title`, optional: `app_id`, `description`) |

| `fc_edit_list` | Edit a list (`list_id`, `title`, optional: `app_id`, `description`) |

| `fc_delete_list` | Delete a list (`list_id`, optional: `app_id`) |

### Comments

| Tool | Description |

|------|-------------|

| `fc_add_comment` | Add a comment (`item_id`, `app_id`, `description`, optional: `attached_ids`) |

| `fc_edit_comment` | Edit a comment (`comment_id`, `description`) |

| `fc_delete_comment` | Delete a comment (`comment_id`) |

### Calendar Events

| Tool | Description |

|------|-------------|

| `fc_fetch_events` | List events (optional: `project_id`) |

| `fc_fetch_event` | Get an event (`event_id`) |

| `fc_add_event` | Create an event (`project_id`, `title`, `start_date`, optional: `description`, `f_all_day`, `end_date`, `r_rule`, `mixed_users`) |

| `fc_edit_event` | Edit an event (`event_id`, optional fields) |

| `fc_delete_event` | Delete an event (`event_id`) |

| `fc_fetch_calendar_items` | List calendar items for a project (optional: `project_id`) |

### Discussions

| Tool | Description |

|------|-------------|

| `fc_fetch_discussions` | List discussions (`project_id`, optional: `limit`, `offset`) |

| `fc_fetch_discussion` | Get a discussion (`discussion_id`) |

| `fc_add_discussion` | Create a discussion (`title`, `project_id`, optional: `description`, `list_id`, `f_sticky`, `f_private`) |

| `fc_edit_discussion` | Edit a discussion (`discussion_id`, optional fields) |

| `fc_delete_discussion` | Delete a discussion (`discussion_id`) |

### Issues

| Tool | Description |

|------|-------------|

| `fc_fetch_issues` | List issues (`project_id`, optional: `limit`, `offset`) |

| `fc_fetch_issue` | Get an issue (`issue_id`) |

| `fc_add_issue` | Create an issue (`title`, `project_id`, optional: `description`, `priority`, `status`, `type`, `assigned_to_id`, `due_date`) |

| `fc_edit_issue` | Edit an issue (`issue_id`, optional fields) |

| `fc_delete_issue` | Delete an issue (`issue_id`) |

### Milestones

| Tool | Description |

|------|-------------|

| `fc_fetch_milestones` | List milestones (`project_id`, optional: `limit`, `offset`) |

| `fc_fetch_milestone` | Get a milestone (`milestone_id`) |

| `fc_add_milestone` | Create a milestone (`title`, `project_id`, optional: `description`, `priority`, `assigned_to_id`, `due_date`, `start_date`) |

| `fc_edit_milestone` | Edit a milestone (`milestone_id`, optional fields) |

| `fc_delete_milestone` | Delete a milestone (`milestone_id`) |

### Time Tracking

| Tool | Description |

|------|-------------|

| `fc_fetch_times` | List time entries (`project_id`, optional: `limit`, `offset`) |

| `fc_fetch_time` | Get a time entry (`time_id`) |

| `fc_add_time` | Log time (`project_id`, `date`, `minutes_count`, optional: `description`, `assigned_to_id`, `f_started`, `f_billed`) |

| `fc_edit_time` | Edit a time entry (`time_id`, optional fields) |

| `fc_delete_time` | Delete a time entry (`time_id`) |

| `fc_time_action` | Perform action on a timer (`time_id`, `action`: `start`/`stop`/`bill`/`unbill`) |

### Wikis

| Tool | Description |

|------|-------------|

| `fc_fetch_wikis` | List wikis (`project_id`, optional: `limit`, `offset`, `order_title`) |

| `fc_fetch_wiki` | Get a wiki (`wiki_id`) |

| `fc_add_wiki` | Create a wiki (`title`, `project_id`, optional: `description`, `list_id`, `f_private`, `f_public`) |

| `fc_edit_wiki` | Edit a wiki (`wiki_id`, optional fields) |

| `fc_delete_wiki` | Delete a wiki (`wiki_id`) |

| `fc_add_wiki_version` | Add a wiki version (`wiki_id`, optional: `title`, `description`) |

### CRM Tasks

| Tool | Description |

|------|-------------|

| `fc_fetch_crm_tasks` | List CRM tasks (`group_id`, optional: `limit`, `offset`) |

| `fc_fetch_crm_task` | Get a CRM task (`crm_task_id`) |

| `fc_add_crm_task` | Create a CRM task (`title`, `group_id`, optional: `description`, `type`, `assigned_to_id`, `due_date`) |

| `fc_edit_crm_task` | Edit a CRM task (`crm_task_id`, optional fields) |

| `fc_delete_crm_task` | Delete a CRM task (`crm_task_id`) |

### CRM Calls

| Tool | Description |

|------|-------------|

| `fc_fetch_crm_calls` | List CRM calls (`group_id`, optional: `limit`, `offset`) |

| `fc_fetch_crm_call` | Get a CRM call (`crm_call_id`) |

| `fc_add_crm_call` | Create a CRM call (`title`, `group_id`, optional: `description`, `f_inbound`, `assigned_to_id`, `due_date`, `duration`) |

| `fc_edit_crm_call` | Edit a CRM call (`crm_call_id`, optional fields) |

| `fc_delete_crm_call` | Delete a CRM call (`crm_call_id`) |

### Users & Account

| Tool | Description |

|------|-------------|

| `fc_fetch_users` | List all users |

| `fc_fetch_current_user` | Get the authenticated user |

| `fc_fetch_user` | Get a user by ID (`user_id`) |

| `fc_update_current_user` | Update profile (`first_name`, `last_name`, `email`, `timezone`, `password`) |

| `fc_register_user` | Register a new user (`email`, `password`, `first_name`, `last_name`) |

| `fc_delete_avatar` | Delete current user avatar |

| `fc_delete_account` | Delete the account (`password`) |

| `fc_request_password_reset` | Request password reset email (`email`) |

| `fc_apply_password_reset` | Apply password reset (`reset_key`, `password`) |

| `fc_validate_email` | Validate an email address (`email`) |

### Groups & Notifications

| Tool | Description |

|------|-------------|

| `fc_fetch_groups` | List all groups |

| `fc_fetch_notifications` | Get recent notifications |

| `fc_fetch_notifications_by_project` | Get notifications for a project (`project_id`) |

| `fc_update_notification_read` | Mark notification as read (optional: `uid`) |

| `fc_edit_notifications` | Bulk update notification state (`items`, optional: `new_state`) |

### Miscellaneous

| Tool | Description |

|------|-------------|

| `fc_fetch_cf_templates` | List custom field templates (optional: `module_id`) |

| `fc_fetch_linked_items` | Get linked items (`app_id`, `item_id`) |

| `fc_add_linked_items` | Link items together (`app_id`, `item_id`, `links`) |

| `fc_fetch_current_session` | Get current session info |

| `fc_fetch_invitations` | List pending invitations |

| `fc_respond_invitation` | Respond to an invitation (`invitation_id`, optional: `action`, `response`) |

| `fc_fetch_timezones` | List available timezones |

| `fc_fetch_backups` | List account backups |

---

## License

MIT
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/agrublev/freedcamp-mcp

Awesome Lists containing this project

README
