Mini Task MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mini Task MCP Server list all my tasks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Mini Task MCP Server
A simple Model Context Protocol (MCP) project built with TypeScript and Node.js.
This project demonstrates how an MCP Client communicates with an MCP Server and uses MCP tools to manage tasks through a standardized protocol.
š Features
MCP Server implementation
MCP Client implementation
STDIO transport communication
Task management system
Create new tasks
View all tasks
Update existing tasks
Complete tasks
Delete tasks
JSON file-based storage
Type-safe development using TypeScript
Related MCP server: Todo4Agent
š ļø Tech Stack
Node.js
TypeScript
Model Context Protocol SDK
Zod Validation
JSON Storage
š MCP Architecture
User
|
|
MCP Client
|
|
Model Context Protocol
|
|
MCP Server
|
|
Task Management Tools
|
|
tasks.jsonš§ Available MCP Tools
1. add_task
Creates a new task.
Example:
{
"title": "Complete MCP project",
"description": "Finish MCP server implementation"
}2. list_tasks
Returns all available tasks.
Example response:
[
{
"id": 1,
"title": "Learn MCP",
"status": "pending"
}
]3. update_task
Updates an existing task.
Example:
{
"id": 1,
"title": "Updated task title"
}4. complete_task
Marks a task as completed.
Example:
{
"id": 1
}5. delete_task
Deletes a task using its ID.
Example:
{
"id": 1
}š Project Structure
mini-task-mcp
ā
āāā src
ā āāā server.ts # MCP Server implementation
ā āāā client.ts # MCP Client implementation
ā
āāā tasks.json # Task storage
ā
āāā package.json
āāā package-lock.json
āāā tsconfig.json
āāā README.md
āāā .gitignoreāļø Installation
Clone the repository:
git clone https://github.com/yourusername/mini-task-mcp.gitNavigate into project:
cd mini-task-mcpInstall dependencies:
npm installā¶ļø Running the Project
Build TypeScript
npm run buildStart MCP Server
npm startRun MCP Client
npm run clientš How MCP Works in This Project
The MCP Client sends a request.
The MCP Server receives the request.
The server identifies the required tool.
The selected tool performs the task operation.
The result is returned back to the client.
Example:
Client
|
| Request: Add Task
ā
MCP Server
|
| Executes add_task tool
ā
tasks.json updated
|
ā
Response returned to ClientšÆ Project Purpose
The purpose of this project is to understand the fundamentals of Model Context Protocol (MCP) and how AI applications can securely interact with external tools and data sources.
This mini project demonstrates the foundation required for building AI assistants that can perform real-world operations using connected services.
š® Future Improvements
Add SQLite database support
Add authentication system
Add REST API support
Add AI-powered task assistant
Connect with LLM-based MCP clients
Add cloud deployment support
šØāš» Author
Mohd Samir Shaikh
Mini MCP Task Management Project
Available Tools
6 toolsadd_taskC
Add a new task to the local task manager.
Inputs: title (required), description.
complete_taskC
Mark an existing task as completed.
Inputs: taskId (required).
delete_taskB
Delete an existing task using its task ID.
Inputs: taskId (required).
get_taskB
Get the complete details of one task using its task ID.
Inputs: taskId (required).
list_tasksC
List all tasks or filter them by pending or completed status.
Inputs: status.
update_taskA
Update the title or description of an existing task using its task ID.
Inputs: taskId (required), title, description.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 6 tools
Each tool has a unique action (add, complete, delete, get, list, update) with no overlap, making selection unambiguous.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., add_task, complete_task), adhering perfectly to the convention.
With 6 tools covering core task operations (CRUD + status), the count is well-scoped for a local task manager.
Covers the full lifecycle except for a 'reopen' or 'set pending' operation; update_task only modifies title/description, not status, which is a minor gap.
Maintenance
Related MCP Connectors
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Create, list, and complete todo items through MCP.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables task management (create, list, update tasks with priority and status) using SQLite storage via MCP tools.3-
- AlicenseNot gradedqualityCmaintenanceEnables agents to manage personal task lists through the MCP protocol, supporting task creation, editing, completion, deletion, grouping, reordering, and JSON import/export.1AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables managing tasks in a structured TODO.md file through MCP tools for listing, adding, updating, setting status, logging notes, searching, and removing tasks while preserving hand-authored formatting.9 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables managing tasks through a simple task tracker with REST API and MCP tools for listing, creating, updating, assigning, and deleting tasks.-