EARLY App MCP Server

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.