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

Related MCP server: Taskwarrior MCP Server

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

MCP Resources

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"]
    }
  }
}