@opentask/taskin-mcp

Model Context Protocol (MCP) server for task management integration with LLMs like Claude, GPT-4, and GitHub Copilot.

Features

✅ Full MCP protocol implementation
✅ Exposes task operations as MCP tools
✅ Task context via MCP resources
✅ Task templates via MCP prompts
✅ Real-time task updates
✅ TypeScript support
✅ Auto-discovery in VS Code and Claude Desktop

Quick Start

VS Code (GitHub Copilot)

The server will appear automatically in VS Code's MCP server list after installation:

npm install -g @opentask/taskin-mcp

Then in VS Code:

Open Command Palette (Cmd+Shift+P)
Search for "Configure Tools"
Find "taskin" in the MCP servers list
Enable it

Or add manually to your settings.json:

{
  "github.copilot.chat.mcpServers": {
    "taskin": {
      "command": "taskin-mcp-server"
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "taskin": {
      "args": ["-y", "@opentask/taskin-task-server-mcp"],
      "command": "npx"
    }
  }
}

Installation

Global (Recommended)

npm install -g @opentask/taskin-mcp

Project-specific

pnpm add @opentask/taskin-mcp

Programmatic Usage

import { createTaskManager } from '@opentask/taskin-task-manager';
import { createTaskMCPServer } from '@opentask/taskin-task-server-mcp';

// Create task manager with your provider
const taskManager = createTaskManager({
  provider: 'fs',
  config: { tasksDirectory: './TASKS' },
});

// Start MCP server
const server = createTaskMCPServer(taskManager, {
  name: 'taskin-server',
  version: '1.0.0',
});

await server.connect({
  transport: 'stdio', // or 'sse'
});

console.log('MCP server running');

MCP Tools

list_tasks - List all tasks with filters
get_task - Get task details
start_task - Start working on a task
finish_task - Mark task as complete
pause_task - Pause task work
lint_tasks - Validate tasks

JSPM

@opentask/taskin-task-server-mcp

Package Exports

Readme