work-tracker-mcp

MCP server that tracks what you are working on. Logs are stored locally as one markdown file per day on your Desktop.

Works with Cursor and Claude Code.

Quick install

git clone https://github.com/venkatd-media/work-tracker-mcp.git ~/Projects/work-tracker-mcp
cd ~/Projects/work-tracker-mcp
./scripts/install.sh

The install script will:

• Build the MCP server
• Register it in Claude Code (user scope, all projects)
• Register it in Cursor (~/.cursor/mcp.json)
• Append work-tracking instructions to ~/.claude/CLAUDE.md and ~/.cursor/AGENTS.md

Then reload MCP in Cursor and start a new Claude Code session.

Storage

Default folder: ~/Desktop/work-tracker/

Each day gets a file like 2026-07-06.md:

# 2026-07-06

## Focus
Building the work-tracker MCP server

## Project
/Users/venkat.c/Projects/work-tracker-mcp

## Log
- 21:30 — Started scaffolding
- 21:45 — Switched to daily Desktop files

Override the folder with WORK_TRACKER_DIR.

Concurrent writes from Cursor and Claude Code are safe: each day file is updated under an exclusive lock with atomic replace, so overlapping sessions cannot lose log entries.

Claude Code

One-command setup (recommended)

./scripts/install.sh

Manual setup

npm install
npm run build
claude mcp add --scope user work-tracker -- node /absolute/path/to/work-tracker-mcp/dist/index.js

Use --scope user so the server is available in every project, not just this repo.

Import from this repo

If you open this repository in Claude Code, .mcp.json is included. Set the repo path first:

export WORK_TRACKER_MCP_ROOT=~/Projects/work-tracker-mcp

Then approve the work-tracker server when prompted.

Cursor

One-command setup

./scripts/install.sh

Manual setup

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "work-tracker": {
      "command": "node",
      "args": ["/absolute/path/to/work-tracker-mcp/dist/index.js"]
    }
  }
}

For automatic tracking in every workspace, also keep the work-tracking section in ~/.cursor/AGENTS.md (the install script adds it).

Tools

Tool	Description
get_current_work	Read today's focus and log
set_focus	Set what you are working on
log_progress	Append a timestamped note
read_day	Read a specific day's file
list_days	List available day files

Requirements

• Node.js 20+
• Cursor and/or Claude Code with MCP support