🚀 7pace Timetracker MCP Server

• Supercharge your Azure DevOps workflow with intelligent time tracking through AI assistants

Transform your development workflow with seamless time tracking that speaks your language – literally.

🎯 Quick Start • ✨ Features • 📖 Documentation • 🤝 Contributing

🎯 Why 7pace MCP?

"Stop context switching. Start smart tracking."

Traditional time tracking tools interrupt your flow. Our MCP server integrates directly into Claude AI, letting you track time using natural language without leaving your coding environment.

🔥 The Problem We Solve

• ❌ Context Switching: Jumping between IDE → Browser → Time Tracker

• ❌ Manual Entry: Remembering what you worked on hours later

• ❌ Workflow Disruption: Breaking focus to log time

• ❌ Data Silos: Time tracking disconnected from your actual work

✅ Our Solution

• ✨ Natural Language: "Log 2 hours on work item 7128 for API refactoring"

• ⚡ Zero Context Switch: Track time directly in Claude AI

• 🔄 Real-time Sync: Instant Azure DevOps integration

• 📊 Smart Reports: AI-powered insights into your productivity

✨ Features

🎯 Core Functionality

• 🕐 Smart Time Logging - Natural language time entry

• 📋 Worklog Management - View, edit, delete entries

• 📊 Intelligent Reports - Automated time analysis

• 🔍 Advanced Filtering - Date ranges, work items, users

• ⚙️ Activity Types - Automatic resolution by name or ID

🚀 Developer Experience

• 🗣️ Conversational Interface - Chat with your time tracker

• ⚡ Instant Setup - One-line NPX installation

• 🔄 Real-time Sync - Live Azure DevOps integration

• 🛡️ Type Safety - Full TypeScript support

• 📱 Universal Access - Works in Cursor, VS Code, and more

🚀 Quick Start

Option 1: Smithery (Easiest)

Option 2: NPX (Direct)

Option 3: Clone & Build

🔧 Configuration

For Cursor IDE:

For VS Code:

Create .vscode/mcp.json:

🎮 Usage Examples

Natural Language Time Tracking

Smart Reporting

Intelligent Queries

📖 API Reference

Parameters:

• workItemId (number): Azure DevOps Work Item ID

• date (string): Date in YYYY-MM-DD format

• hours (number): Hours worked

• description (string): Work description

• activityType (string, optional): Activity type name or ID

Note: The server calls 7pace using date, length and billableLength (seconds) with comment. You only provide hours; conversion is handled for you.

Example:

Parameters:

• workItemId (number, optional): Filter by work item

• startDate (string, optional): Start date filter

• endDate (string, optional): End date filter

Example:

Returns a text list of activity type IDs and names from 7pace so you can pick a valid GUID if your org requires it.

Parameters:

• worklogId (string): ID of worklog to update

• hours (number, optional): New hours

• description (string, optional): New description

• workItemId (number, optional): New work item ID

Parameters:

• worklogId (string): ID of worklog to delete

Parameters:

• startDate (string): Start date in YYYY-MM-DD format

• endDate (string): End date in YYYY-MM-DD format

• userId (string, optional): Filter by user

🔐 Setup Guide

1. Get Your 7pace API Token

1. Navigate to Azure DevOps → 7pace Timetracker

2. Go to Settings → API & Reporting

3. Click "Create New Token"

4. Copy the token for your environment configuration

2. Environment Variables

3. Test Your Setup

🏗️ Architecture

Key Components:

• MCP Server: Handles protocol communication and business logic

• 7pace Service: Manages API interactions and data transformation

• Activity Type Resolution: Smart matching of activity names to IDs

• Error Handling: Comprehensive validation and user-friendly messages

🚀 Advanced Usage

Custom Activity Types

Bulk Operations

Integration Patterns

• Sprint Planning: Generate reports for sprint retrospectives

• Client Billing: Export time data for invoicing

• Performance Analysis: Track productivity trends

• Compliance Reporting: Automated time tracking audit trails

🤝 Contributing

We welcome contributions! Here's how to get started:

Development Setup

Contributing Guidelines

• 🐛 Bug Reports: Use GitHub Issues with detailed reproduction steps

• ✨ Feature Requests: Describe your use case and proposed solution

• 🔧 Pull Requests: Include tests and update documentation

• 📝 Documentation: Help improve our guides and examples

Development Commands

📈 Roadmap

🔜 Coming Soon

• Web Dashboard: Visual time tracking interface

• Slack Integration: Time tracking via Slack commands

• Mobile Support: Companion mobile app

• Advanced Analytics: AI-powered productivity insights

• Team Management: Multi-user organization features

🎯 Long-term Vision

• Cross-platform MCP: Support for other time tracking tools

• AI Suggestions: Intelligent work categorization

• Workflow Automation: Auto-tracking based on git commits

• Enterprise Features: SSO, audit logs, compliance reporting

📊 Performance & Reliability

• ⚡ Fast Response Times: < 200ms average API response

• 🔄 Smart Caching: 5-minute activity type cache for performance

• 🛡️ Error Recovery: Graceful handling of API failures

• 📈 Scalable: Handles high-volume time tracking workflows

• 🔒 Secure: Token-based authentication with environment isolation

🌟 Community & Support

Join Our Community

Have questions? Open a GitHub Discussion
Found a bug? Report it in Issues
Need help? Check our Documentation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by developers, for developers

⭐ Star this repo if it helped you track time more efficiently!

🚀 Get Started • 📖 Documentation • 💬 Community