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