CloudFramework Projects MCP Server

MCP Server for CloudFramework Projects API - Manage tasks and log work through Claude Desktop.

Installation

No installation required! Use directly with npx.

Quick Start with Claude Desktop

1. Configure Claude Desktop:

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "cloudframework-projects": {
      "command": "npx",
      "args": [
        "-y",
        "cloudframework-projects-mcp"
      ]
    }
  }
}

2. Restart Claude Desktop

3. Get your credentials:

Before using the MCP, you need:

• User: Your CloudFramework email (e.g., [email protected])
• Token: Your authentication token from CloudFramework

To get your token, login to CloudFramework and go to your profile settings or contact your administrator.

4. Use in Claude:

List my tasks for user "[email protected]" with token "your_token_here"

Available Tools

Basic Task Management

1. projects_check

Check API health and connectivity.

Parameters:

• user (string): User identifier
• token (string): Authentication token (X-DS-TOKEN)

2. projects_list_tasks

List all active tasks (not closed or canceled).

Parameters:

• user (string): User identifier
• token (string): Authentication token

3. projects_get_task

Get detailed task information.

Parameters:

• user (string): User identifier
• token (string): Authentication token
• task_id (string): Task identifier

4. projects_log_work

Log work hours on a task.

Parameters:

• user (string): User identifier
• token (string): Authentication token
• task_id (string): Task identifier
• description (string): Work description
• start (string): Start time (ISO format) - Required
• end (string, optional): End time (ISO format)
• time_spent (number, optional): Hours spent (e.g., 1.5 for 1h 30m)
• title (string, optional): Custom title for work log entry

Daily Tasks (New in v1.1.0)

5. projects_today_tasks

Get tasks active for today assigned to you.

Parameters:

• user (string): User identifier
• token (string): Authentication token

Returns: Open tasks where Start Date <= Today

6. projects_today_all_tasks

Get ALL tasks active for today (Admin only).

Parameters:

• user (string): User identifier
• token (string): Authentication token

Returns: All open tasks where Start Date <= Today Requires: projects-admin privilege

Sprint Management (New in v1.1.0)

7. projects_current_sprint_tasks

Get your tasks in the current active sprint.

Parameters:

• user (string): User identifier
• token (string): Authentication token

8. projects_current_sprint_all_tasks

Get ALL tasks in the current sprint (Admin only).

Parameters:

• user (string): User identifier
• token (string): Authentication token

Requires: projects-admin privilege

9. projects_list_sprints

List recent sprints (last 3 months, Admin only).

Parameters:

• user (string): User identifier
• token (string): Authentication token

Requires: projects-admin privilege

10. projects_sprint_tasks

Get all tasks for a specific sprint (Admin only).

Parameters:

• user (string): User identifier
• token (string): Authentication token
• sprint_id (string): Sprint identifier

Requires: projects-admin privilege

Authentication

You need:

• User: Your CloudFramework user identifier (usually your email)
• Token: Your X-DS-TOKEN authentication token

Get your token from CloudFramework Dashboard or API.

Usage Examples

Basic Operations

Check API:

Check CloudFramework Projects API for user "[email protected]" with token "abc123"

List tasks:

Show me my tasks for user "[email protected]" with token "abc123"

Log work:

Log 2.5 hours on task PROJ-123 for user "[email protected]" with token "abc123" - description: "Implemented login feature"

Log work with custom title:

Log 1.5 hours on task PROJ-456 for user "[email protected]" with token "abc123" - title: "Bug Fix: Login Error" - description: "Fixed authentication timeout issue"

Daily Tasks (v1.1.0)

Get today's tasks:

Show me my tasks for today for user "[email protected]" with token "abc123"

Get all today's tasks (Admin):

Show all tasks for today for user "[email protected]" with token "abc123"

Sprint Management (v1.1.0)

Get current sprint tasks:

Show me my current sprint tasks for user "[email protected]" with token "abc123"

List recent sprints (Admin):

List all recent sprints for user "[email protected]" with token "abc123"

Get tasks for specific sprint (Admin):

Show all tasks for sprint "SPRINT-2024-Q1" for user "[email protected]" with token "abc123"

Development

Local Testing

# Clone the repository
git clone https://github.com/CloudFramework-io/cloudframework-projects-mcp.git
cd cloudframework-projects-mcp

# Install dependencies
npm install

# Test with MCP Inspector
npm run inspector

HTTP Mode

# Run as HTTP server
npm run dev

# Test with curl
curl -X POST http://localhost:8080/mcp/call \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "projects_list_tasks",
    "arguments": {
      "user": "your_user",
      "token": "your_token"
    }
  }'

Configuration

The server uses fixed values for:

• X-WEB-KEY: DevelopmentProd
• PLATFORM: cloudframework

Optional environment variable:

• CLOUDFRAMEWORK_API_URL: API base URL (default: https://api.cloudframework.dev)

Deployment

Docker

docker build -t cloudframework-projects-mcp .
docker run -p 8080:8080 cloudframework-projects-mcp

Google Cloud Run

npm run deploy:cloudrun

API Reference

Base URL: https://api.cloudframework.dev/ai/mcp/cloud-projects/cloudframework/:user

Endpoints

Basic Task Management:

• GET /tasks/check - Health check
• GET /tasks - List active tasks
• GET /tasks/task/:taskId - Get task details
• POST /tasks/task/:taskId/work - Log work (supports optional title parameter)

Daily Tasks (v1.1.0):

• GET /tasks/today - Get user's tasks for today
• GET /tasks/today/all - Get all tasks for today (Admin)

Sprint Management (v1.1.0):

• GET /tasks/sprint/current - Get user's current sprint tasks
• GET /tasks/sprint/current/all - Get all current sprint tasks (Admin)
• GET /tasks/sprint/all - List recent sprints (Admin)
• GET /tasks/sprint/:sprintId/all - Get tasks for specific sprint (Admin)

Requirements

• Node.js >= 18.0.0
• CloudFramework account with API access

License

MIT License - see LICENSE file for details.

Support

• GitHub: https://github.com/CloudFramework-io/cloudframework-projects-mcp/issues
• CloudFramework: https://cloudframework.io/support

Links

• npm
• GitHub
• CloudFramework
• Model Context Protocol