EARLY App Server

npm version Documentation License: MIT Node.js

An unofficial Model Context Protocol (MCP) server that provides access to the EARLY app time tracking public API.

Overview

EARLY is a time tracking application with a comprehensive public API. This MCP server enables AI assistants to interact with time tracking data through the public EARLY API.

Tools

Time Entry Management

• create_time_entry - Create a new time entry with flexible time parameters
• edit_time_entry - Edit an existing time entry
• get_time_entries - Get time entries for a date range
• delete_time_entry - Delete a time entry by ID
• start_timer - Start tracking time for a project
• stop_timer - Stop the currently running timer
• get_active_timer - Get information about the currently running timer
• update_active_timer - Update the description of the currently running timer

Activity Management

• list_activities - Get all activities
• create_activity - Create a new activity (project)
• update_activity - Update an existing activity
• archive_activity - Archive or delete an activity

User & Reports

• generate_report - Generate summary reports for time entries
• get_current_user - Get current user information

Resources

Time Entries

• early://time-entries/today - Today's time entries with detailed JSON data
• early://time-entries/week - Current week's time entries

Activities

• early://activities - All activities (active + inactive + archived)
• early://activities/active - Only active activities

Quick Start

Installation

No installation required! Use npx to run the server:

npx @janfincke/early-mcp-server

Configuration (for Claude Desktop and others)

{
  "mcpServers": {
    "early-time-tracker": {
      "command": "npx",
      "args": [
        "@janfincke/early-mcp-server"
      ],
      "env": {
        "EARLY_API_KEY": "your-early-api-key-here",
        "EARLY_API_SECRET": "your-early-api-secret-here"
      }
    }
  }
}

Get your API credentials from the EARLY desktop app: Settings → Developer → API Keys

Documentation

Complete Documentation

Comprehensive documentation is available at janfincke.github.io/early-mcp-server including:

• Getting Started Guide - Installation and setup
• Tools Reference - Complete documentation for all 6 tools
• Integration Guide - Claude Desktop and MCP client setup
• Troubleshooting - Common issues and solutions

EARLY API Documentation

• Base URL: https://developers.early.app/
• Documentation: Postman Collection
• Authentication: API Key (assumed)

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

License

MIT License - see LICENSE file for details.