MCP Work History Server

📋 MCP Work History Server

🤖 A Model Context Protocol (MCP) server that allows AI tools to log their activities to daily worklog files with detailed tracking of tool names, AI models, and timestamps.

✨ Features

🕐 Precise timestamps - Logs activities with HH:MM format
🔧 Tool tracking - Records which AI tool performed the action
🧠 Model tracking - Tracks which AI model was used (e.g., gemini-2.5-pro, claude-3-sonnet)
📊 Comprehensive metrics - Token usage, context length, duration, cost tracking
🏷️ Tagging system - Categorize activities with custom tags
✅❌ Success/failure tracking - Log both successful operations and errors
📁 Daily organization - Creates separate markdown files for each day
📝 Clean format - Bullet-point style entries for easy scanning
🎯 MCP compatible - Works with any MCP-enabled AI client

🚀 Installation

npm install

🎮 Usage

Start the MCP server:

npm start

Or run in development mode with auto-restart:

npm run dev

🛠️ MCP Tool

The server provides one tool:

`log_activity`

Logs an AI tool's activity to the current day's worklog file in a concise, scannable format.

Parameters:

Required:

tool_name (string): Name of the AI tool (e.g., "Warp", "Claude Code", "GitHub Copilot")
log_message (string): Detailed description of what was accomplished

Optional:

ai_model (string): AI model used (e.g., "gemini-2.5-pro", "claude-3-sonnet", "gpt-4")
tokens_used (number): Total tokens consumed in the request
input_tokens (number): Input tokens used (alternative to tokens_used)
output_tokens (number): Output tokens generated (alternative to tokens_used)
context_length (number): Context window length used (in thousands)
duration_ms (number): Duration of the operation in milliseconds
cost_usd (number): Estimated cost in USD
success (boolean): Whether the operation was successful (defaults to true)
error_message (string): Error message if operation failed
tags (array): Tags to categorize the activity (e.g., ["coding", "debugging", "refactoring"])

Example log entries:

# 📝 Work Log - 2024-01-15

- ✅ 08:31 - Warp (gemini-2.5-pro): Refactored authentication module to use JWT tokens (1250 tokens | 8k ctx | 2.3s | $0.0043 | [refactoring, auth])
- ✅ 09:15 - Claude Code (claude-3-sonnet): Fixed database connection pooling issue (850→320 tokens | 1.1s | $0.0021)
- ❌ 10:42 - GitHub Copilot (gpt-4): Attempted to implement user profile endpoint (❌ Timeout error | [coding, api])
- ✅ 11:30 - Warp: Quick code review and suggestions (500 tokens | 0.8s)

📂 Log File Structure

Logs are stored in the logs/ directory with the naming pattern worklog-YYYY-MM-DD.md.

Each log file contains:

📝 Emoji-enhanced date header
🕐 Timestamped bullet-point entries
🔧 Tool name and AI model information
📋 Concise activity descriptions

⚙️ MCP Configuration

For Warp AI

Add this server to your Warp MCP configuration:

{
  "mcp-work-history": {
    "command": "node",
    "args": ["/Users/your-username/path/to/mcp-work-history/src/index.js"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

For Claude Desktop

Add to your claude_desktop_config.json:

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

Example Usage in AI Tools

Once configured, AI tools can log their activities like this:

Basic usage:

log_activity({
  tool_name: "Warp",
  log_message: "Created React component for user dashboard"
})

With comprehensive metrics:

log_activity({
  tool_name: "Warp",
  ai_model: "gemini-2.5-pro",
  log_message: "Refactored authentication system with OAuth integration",
  tokens_used: 1250,
  context_length: 8,
  duration_ms: 2300,
  cost_usd: 0.0043,
  success: true,
  tags: ["refactoring", "auth", "oauth"]
})

Error logging:

log_activity({
  tool_name: "GitHub Copilot",
  ai_model: "gpt-4",
  log_message: "Attempted to implement user profile endpoint",
  input_tokens: 800,
  output_tokens: 0,
  success: false,
  error_message: "Timeout error",
  tags: ["coding", "api"]
})

🗂️ Project Structure

mcp-work-history/
├── 📄 src/index.js          # Main MCP server code
├── 📁 logs/                 # Daily worklog files (auto-created)
│   ├── worklog-2024-01-15.md
│   └── worklog-2024-01-16.md
├── 📦 package.json          # Dependencies and scripts
├── 🚫 .gitignore           # Git ignore rules
└── 📋 README.md            # This file

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

🎯 Real-World Example: Warp AI Integration

Here's how to set up automatic activity logging in Warp AI:

Step 1: Configure MCP Server in Warp

Add the following to your Warp MCP configuration:

{
  "mcp-work-history": {
    "command": "node",
    "args": ["/Users/nocoo/Workspace/mcp-work-history/src/index.js"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Step 2: Add Logging Rule to Warp

Configure Warp with this rule to automatically log AI activities:

Rule: "When AI task is done, use mcp-work-history to log this time AI task details. Send AI tool name (Warp), model used, detailed time, and a brief summary of this time task and result."

Step 3: See It in Action

Warp MCP Work History Integration

Screenshot showing the MCP Work History server automatically logging AI activities in Warp

What Gets Logged

With this setup, every AI interaction in Warp will automatically create entries like:

# 📝 Work Log - 2024-12-06

- ✅ 14:32 - Warp (gemini-2.5-pro): Refactored React component to use custom hooks for state management (1240 tokens | 4.2s | [refactoring, react])
- ✅ 14:45 - Warp (gemini-2.5-pro): Fixed TypeScript type errors in authentication module (890 tokens | 2.1s | [bugfix, typescript])
- ✅ 15:10 - Warp (gemini-2.5-pro): Added comprehensive unit tests for user service (1560 tokens | 3.8s | [testing, unit-tests])

Benefits

📊 Automatic tracking - No manual logging required
🔍 Detailed insights - Track token usage, performance, and costs
📈 Progress monitoring - See your daily coding accomplishments
🏷️ Activity categorization - Organize work with tags
💰 Cost tracking - Monitor AI usage costs over time

📄 License

MIT License - see the LICENSE file for details.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

Tools

log_activity

A Model Context Protocol server that enables AI tools to automatically log their activities with detailed metrics like timestamps, token usage, and costs into daily markdown worklog files.

Related MCP Servers

Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
84
40
Python
MIT License
Logseq MCP Tools
joelhooks
-
security
F
license
-
quality
A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
Last updated -
19
TypeScript
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
TypeScript
Logseq MCP Tools
apw124
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to interact with local Logseq knowledge graphs, supporting operations like creating/editing pages and blocks, searching content, and managing journal entries.
Last updated -
13
7
Python
MIT License

View all related MCP servers

MCP Work History Server