Skip to main content
Glama
EARLY App MCP Server

EARLY App MCP Server

by janfincke

EARLY App MCP 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

Related MCP server: TimePRO MCP Server

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:

EARLY API Documentation

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.

Available Tools

14 tools
archive_activityArchive ActivityC
Destructive

Archive or delete an activity

Inputs: activityId (required).

create_activityCreate ActivityB

Create a new activity (project)

Inputs: name (required), color, billable, clientId, +1 more.

create_time_entryCreate Time EntryC

Create a new time entry with flexible time parameters

Inputs: projectId (required), description (required), endTime, duration, +1 more.

delete_time_entryDelete Time EntryC
Destructive

Delete a time entry by ID

Inputs: timeEntryId (required).

edit_time_entryEdit Time EntryC

Edit an existing time entry

Inputs: timeEntryId (required), endTime, startTime, activityId, +1 more.

generate_reportGenerate ReportB
Read-only

Generate a summary report of time entries for a given period

Inputs: endDate (required), startDate (required), projectId.

get_active_timerGet Active TimerA
Read-only

Get information about the currently running timer

Inputs: no named parameters.

get_current_userGet Current UserA
Read-only

Get information about the currently authenticated user

Inputs: no named parameters.

get_time_entriesGet Time EntriesB
Read-only

Get time entries for a date range

Inputs: endDate, projectId, startDate.

list_activitiesList ActivitiesC
Read-only

Get all activities

Inputs: activeOnly.

start_timerStart TimerC

Start tracking time for an activity

Inputs: projectId (required), description.

stop_timerStop TimerA

Stop the currently running timer

Inputs: no named parameters.

update_active_timerUpdate Active TimerA

Update the description of the currently running timer

Inputs: description (required).

update_activityUpdate ActivityC

Update an existing activity

Inputs: activityId (required), name, color, billable, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, especially around timers, time entries, and activities. There is some potential overlap between create_time_entry and start_timer, but the descriptions clarify the difference between completed entries and a running timer.

    Naming Consistency4/5

    The tool names consistently use snake_case with a verb_noun pattern. Minor inconsistency appears in using edit_time_entry versus update_activity for similar edit/update operations.

    Tool Count5/5

    With 14 tools, the set is well-scoped for a time-tracking and activity-management server. Each tool appears to earn its place without excessive surface area.

    Completeness4/5

    The server covers core workflows: user context, timers, time-entry CRUD, activity lifecycle, and reporting. Minor gaps exist, such as fetching a single activity by ID, but agents can work around them via list_activities.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for the Paymo platform that enables AI assistants to manage time entries, projects, and tasks through natural language. It supports tracking unbilled revenue and generating detailed invoice timesheets for efficient project management.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps the TimePRO API, enabling AI assistants to automatically create, view, and manage timesheets for authenticated users. It provides tools for searching clients and projects, retrieving configuration defaults, and performing full CRUD operations on timesheet entries.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for time tracking and billing that allows freelancers to control timers, manage projects, and export invoices via natural language in any MCP-compatible AI assistant.
      7 npm
      MIT