janfincke/early-mcp-server

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
• start_timer - Start tracking time for a project
• stop_timer - Stop the currently running timer

Activity Management

• list_activities - Get all activities

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)

Future Enhancements

Planned Tools

• delete_time_entry - Delete a time entry
• get_active_timer - Get currently running timer information
• create_activity - Create a new activity
• update_activity - Update activity details
• delete_activity - Delete an activity

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.