task-management-mcp-server by chandan-codeprism - MCP Server

Task Management MCP Server

A comprehensive task management system built as a Model Context Protocol (MCP) server, providing full CRUD operations for task management with multi-user assignment capabilities.

Features

✅ Complete CRUD Operations - Create, Read, Update, Delete tasks
👥 Multi-user Assignment - Assign tasks to different team members
📊 Status Tracking - Monitor task progress with customizable status
⏰ Automatic Timestamps - UTC timezone tracking for created/updated times
🔍 Task Filtering - Retrieve all tasks or specific tasks by ID
📝 Detailed Descriptions - Rich task descriptions and metadata
🚀 MCP Integration - Seamless integration with AI assistants

Installation

Prerequisites

Java 11 or higher (JDK)
Maven 3.6+ or Gradle 6+
Git

Setup

Clone the repository

git clone https://github.com/yourusername/task-management-mcp-server.git
cd task-management-mcp-server

Build the project

Using Maven:
```
mvn clean install
```
Using Gradle:
```
./gradlew build
```

Run the server

Using Maven:

mvn spring-boot:run

Using Gradle:

./gradlew bootRun

Using JAR:

java -jar target/task-management-mcp-server-1.0.0.jar

MCP Configuration

To use this server with Claude Desktop or other MCP clients, add the following configuration to your MCP settings file:

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "task-management": {
      "command": "java",
      "args": ["-jar", "path/to/your/task-management-mcp-server/target/task-management-mcp-server-1.0.0.jar"],
      "env": {}
    }
  }
}

Alternative MCP Tools

For other MCP-compatible clients:

# Using MCP CLI
mcp connect task-management-mcp-server

# Or via Java MCP SDK
import com.anthropic.mcp.MCPClient;
MCPClient client = new MCPClient("task-management-mcp-server");

API Reference

Available Tools

1. Create Task

createTask(request)

Description: Create a new task with specified details
Parameters:
- title (string, required): Task title
- description (string, required): Task description
- status (string, required): Task status (e.g., "pending", "completed")
- assignee (string, required): Person assigned to the task

2. Get All Tasks

getAllTasks()

Description: Retrieve all tasks in the system
Returns: Array of all tasks with complete details

3. Get Task by ID

getTaskById(id)

Parameters:
- id (integer, required): Unique task identifier

4. Update Task

updateTask(id, request)

Parameters:
- id (integer, required): Task ID to update
- request (object, required): Updated task details (same format as create)

5. Delete Task

deleteTask(id)

Parameters:
- id (integer, required): Task ID to delete

Task Object Structure

Each task contains the following properties:

{
  "id": 1,
  "title": "Task Title",
  "description": "Detailed task description",
  "status": "pending",
  "assignee": "John Doe",
  "createdAt": [2025, 8, 30, 20, 30, 51, 366682000],
  "updatedAt": [2025, 8, 30, 20, 33, 3, 279679000]
}

Timestamp Format

Timestamps are stored as arrays: [year, month, day, hour, minute, second, nanoseconds] in UTC timezone.

Usage Examples

With Claude AI Assistant

# Create a new task
"Create a task for John to review the quarterly budget"

# View all tasks
"Show me all current tasks"

# Update task status
"Mark task ID 5 as completed"

# Assign task to different person
"Reassign the budget review task to Sarah"

# Delete completed tasks
"Delete task ID 3"

Direct API Usage

// Example: Creating a task
TaskRequest request = new TaskRequest();
request.setTitle("Review monthly reports");
request.setDescription("Analyze sales and performance metrics");
request.setStatus("pending");
request.setAssignee("Alice Smith");

Task newTask = taskService.createTask(request);

// Example: Getting all tasks
List<Task> allTasks = taskService.getAllTasks();
System.out.println("Total tasks: " + allTasks.size());

Common Status Values

While you can use any status values, here are some common ones:

pending - Task not yet started
in-progress - Currently being worked on
completed - Task finished
on-hold - Temporarily paused
cancelled - Task cancelled

Development

Project Structure

task-management-mcp-server/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/yourcompany/taskmanagement/
│   │   │       ├── TaskManagementApplication.java
│   │   │       ├── controller/
│   │   │       │   └── TaskController.java
│   │   │       ├── service/
│   │   │       │   └── TaskService.java
│   │   │       ├── model/
│   │   │       │   └── Task.java
│   │   │       └── repository/
│   │   │           └── TaskRepository.java
│   │   └── resources/
│   │       ├── application.properties
│   │       └── application.yml
│   └── test/
│       └── java/
├── pom.xml               # Maven dependencies
├── build.gradle          # Gradle dependencies (alternative)
└── README.md            # This file

Running Tests

Using Maven:

mvn test

Using Gradle:

./gradlew test

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/new-feature)
Make your changes
Commit your changes (git commit -am 'Add new feature')
Push to the branch (git push origin feature/new-feature)
Create a Pull Request

Troubleshooting

Common Issues

Server won't start:

Check Java version (>=11 required)
Verify Maven/Gradle build completed successfully
Check if port 8080 is available (or configured port)
Review application.properties configuration

Build issues:

Run mvn clean install or ./gradlew clean build
Check Maven/Gradle version compatibility
Verify internet connection for dependency downloads

Tasks not persisting:

Check database configuration in application.properties
Verify database connection and permissions
Review JPA/Hibernate entity mappings

MCP connection issues:

Verify MCP client configuration
Check server logs for connection errors
Ensure correct path in configuration

License

MIT License - see file for details.

Support

📧 Email: support@yourproject.com
🐛 Issues: GitHub Issues
📖 Documentation: Wiki

Changelog

v1.0.0 (Initial Release)

Complete CRUD operations for tasks using Spring Boot
Multi-user assignment support
UTC timestamp tracking with JPA
MCP server integration
Status management system
RESTful API endpoints
H2/PostgreSQL database support

Made with ❤️ for the MCP community