A Model Context Protocol (MCP) server designed for seamless integration with Toggl Track, providing comprehensive time tracking and reporting capabilities with intelligent caching for optimal performance. This server enables AI assistants to manage time tracking workflows through natural language interactions.
⏱️ Key Features
- 🎯 Timer Management: Start, stop, and manage Toggl timers through AI assistant commands
- 📊 Comprehensive Reporting: Generate daily, weekly, and custom time reports with detailed breakdowns
- 🚀 Intelligent Caching: Advanced caching system for optimal performance and reduced API calls
- 📈 Project Analytics: Track time across projects and workspaces with detailed summaries
- 📝 Entry Management: Create, edit, and organize time entries with descriptions and tags
- 🏢 Multi-Workspace Support: Handle multiple Toggl workspaces and switch between them seamlessly
- 🔍 Advanced Filtering: Filter time entries by date ranges, projects, clients, and tags
- 📅 Flexible Date Ranges: Support for predefined periods (today, week, month) and custom ranges
- 🏷️ Tag Management: Organize and categorize time entries with comprehensive tag support
- ⚡ Real-Time Data: Access current running timers and live time tracking information
📊 Reporting Capabilities
- Daily Reports: Detailed breakdown of hours by project and workspace for any given day
- Weekly Reports: Comprehensive weekly summaries with daily breakdowns and project totals
- Project Summaries: Total hours per project across flexible date ranges
- Workspace Analytics: Cross-workspace time tracking and comparison reports
- Custom Periods: Generate reports for any custom date range or predefined periods
🛠️ Technical Features
- TypeScript Implementation: Fully typed codebase for reliability and maintainability
- Intelligent Caching: Multi-level caching with automatic invalidation and performance optimization
- Error Handling: Robust error handling with detailed logging and graceful degradation
- Rate Limiting: Built-in rate limiting to respect Toggl API constraints
- Environment Configuration: Flexible configuration through environment variables
🤖 AI Assistant Integration
- Natural Language Commands: Start tracking “working on project X” or “generate this week’s report”
- Smart Project Detection: Automatically suggest projects based on current context
- Intelligent Reporting: Generate and format reports in response to natural language queries
- Workflow Automation: Automate common time tracking patterns and routines
🚀 Recent Updates
- Enhanced Caching System: Improved performance with multi-level caching and automatic cache invalidation
- Better Error Handling: More robust error handling with detailed logging for better debugging
- TypeScript Improvements: Enhanced type definitions and better IDE support
- Rate Limiting Protection: Built-in protection against API rate limits
Perfect for freelancers, consultants, and teams who want to streamline their time tracking workflows by leveraging AI assistants to manage Toggl Track operations, generate reports, and maintain accurate time records through conversational interfaces.