Tasks MCP Server

An MCP (Model Context Protocol) server for task management with pluggable storage backends.

Project Structure

tasks-mcp-server/
├── package.json          # Bun project config with MCP SDK dependencies
├── tsconfig.json         # TypeScript configuration
└── src/
    ├── index.ts          # Main MCP server entry point
    ├── types.ts          # Task types and Zod schemas
    └── services/
        ├── TaskService.ts       # Abstract TaskService interface
        └── InMemoryTaskService.ts  # In-memory implementation

Installation

bun install

Building

bun run build

Usage

# Start with default in-memory service
bun run start

# Specify service implementation
bun run start -- --service memory

# Show help
bun run start -- --help

Abstract TaskService Interface

The TaskService interface (src/services/TaskService.ts) defines the contract for task storage implementations:

list(status?) - List all tasks, optionally filtered by status
get(id) - Get a single task by ID
create(input) - Create a new task
complete(id) - Mark task as completed
delete(id) - Delete a task

Available Implementations

InMemoryTaskService (src/services/InMemoryTaskService.ts):

Stores tasks in a Map
Generates sequential IDs (task-1, task-2, etc.)
Tasks persist only during server runtime

MCP Tools

Tool	Description
`tasks_list`	List all tasks (supports filtering by status and markdown/json output)
`tasks_create`	Create a new task with title and optional description
`tasks_complete`	Mark a task as completed by ID
`tasks_delete`	Delete a task permanently by ID

MCP Resources

Resource	Description
`task://{id}`	Access individual tasks by ID (template resource)
`task://list`	List all tasks as JSON (static resource)

Integration

The server uses stdio transport, making it suitable for integration with MCP clients like Claude Desktop or other MCP-compatible applications.

Claude Desktop Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "tasks": {
      "command": "bun",
      "args": ["run", "/path/to/tasks-mcp-server/dist/index.js", "--service", "memory"]
    }
  }
}

tasks-mcp