Progress Tracker MCP Server

MCP (Model Context Protocol) server for logging progress data via Claude Code. Track daily check-ins, workouts, and weekly reviews using natural language.

Installation

Via npm (recommended)

npm install -g progress-tracker-mcp

Add to Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "progress-tracker": {
      "command": "progress-tracker-mcp",
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian-vault"
      }
    }
  }
}

From source

1. Clone and install:

git clone https://github.com/Masbuc53/progress-tracker-mcp.git
cd progress-tracker-mcp
npm install
npm run build

2. Add to Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "progress-tracker": {
      "command": "node",
      "args": ["/full/path/to/progress-tracker-mcp/dist/index.js"],
      "env": {
        "VAULT_PATH": "/full/path/to/progress-vault"
      }
    }
  }
}

3. Restart Claude Code to load the MCP server.

Available Tools

progress_log_daily

Log a daily check-in with mirror practice, VILPA bursts, energy, sleep, and notes.

Example:

"Log my daily - mirror practice done, 4 VILPA bursts, energy 4/5, slept 7.5 hours"

progress_log_strength

Log a strength training workout with exercises, sets, reps, and weights.

Example:

"Log strength workout session A:
- Incline dumbbell press: 3x8 at 70 lbs
- Pull-ups: 3x8 at bodyweight
- Dumbbell rows: 3x10 at 60 lbs"

progress_log_agility

Log an agility training session.

Example:

"Log agility session - did shuttle runs, lateral shuffles, and quick feet drills"

progress_log_cardio

Log a cardio session (Norwegian 4x4, Peloton, rucking).

Example:

"Log cardio - Norwegian 4x4, 40 minutes"

progress_weekly_review

Log weekly non-negotiables and reflections.

Example:

"Weekly review - completed strength1, strength2, vilpa, mirror, therapy.
Showed up consistently this week. Struggled with language practice."

progress_get_stats

Get current progress statistics.

Example:

"How am I doing?"

progress_get_streak

Get current daily check-in streak.

Example:

"What's my streak?"

Data Storage

All data is stored as Markdown files in your Obsidian vault:

progress-vault/
├── 01-Daily/YYYY/MM-Month/YYYY-MM-DD.md
├── 02-Workouts/YYYY/MM-Month/YYYY-MM-DD-type.md
├── 03-Weekly/YYYY/YYYY-WNN.md
├── 04-Monthly/YYYY/YYYY-MM.md
└── 05-Quarterly/YYYY-QN.md

Files include YAML frontmatter for structured data and Markdown content for readability in Obsidian.

Git Integration

After each log entry, the server:

1. Stages all changes
2. Commits with a descriptive message
3. Attempts to push (silent failure if offline)

This ensures your data syncs to GitHub and across devices.

Development

# Watch mode for development
npm run dev

# Build for production
npm run build

Requirements

• Node.js 18+
• Git installed and configured
• Vault initialized as a Git repository