Task Tracker

A Model Context Protocol server that integrates Linear task management and TrackingTime time tracking.

Motivation

I've been using Linear for task management and TrackingTime for time tracking for a long time. I found it could be very helpful to use LLM to automate my workflows and tasks.

With the benifits of large language models, I can use natural language to create tasks, update task statuses, start and stop time tracking, and more.

If I develop more MCP servers tailored to my own needs, I can make the Claude client an all-in-one workspace for me.

Features

• Integration with Linear API for task management
• Create new task with optional project, description and state assignments
• Set current working team
• Get projects
• View tasks by status (backlog, unstarted, started, done, canceled)
• Search tasks by title
• Update task status
• Integration with TrackingTime for task time tracking
• Start time tracking for tasks
• Stop active time tracking
• View currently active tracked task
• Add notes to tracking task

Setup

1. setup the environment, refer to the .env.example file.

2. sh scripts/setup.sh to build the package or run below uv commands directly.

uv build 
  uv run task-tracker

3. setup it in the Claude Desktop:

{
  "mcpServers": {
      "task-tracker": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/task-tracker",
              "run",
              "task-tracker"
          ]
      }
  }
}