gitwtfhub

wtf is atimelogger-mcp?

zaplitny/atimelogger-mcp — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developer

TL;DR

An MCP server that connects the ATimeLogger time tracking app to AI assistants, letting you start, stop, log, and report on activities through plain conversation.

Mindmap

mindmap
  root((repo))
    What it does
      MCP server
      Time tracking control
      Activity logging
      Reports and history
    Tech stack
      TypeScript
      Node.js
      MCP
    Use cases
      Conversational time tracking
      Backdated logging
      Remote connector access
    Audience
      Developers
      ATimeLogger users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Start, stop, pause, and log time tracking activities by talking to an AI assistant.

REASON 2

Backdate a forgotten timer or log a completed activity with specific start and end times.

REASON 3

Ask an assistant for time tracking reports and history across chosen periods.

REASON 4

Connect ATimeLogger data to Claude in the browser or on mobile via a remote MCP connector.

What's in the stack?

TypeScriptNode.jsMCP

How it stacks up

zaplitny/atimelogger-mcp000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderate
Complexity2/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

This project is a small server that connects the ATimeLogger time tracking app to AI assistants like Claude and OpenAI's Codex, using a standard called MCP, the Model Context Protocol. Once set up, it lets an assistant read and control a person's time tracking data directly through normal conversation, instead of the user opening the ATimeLogger app themselves. To use it, a person first generates a personal access token inside their ATimeLogger account settings, then registers the server with their AI assistant using a one line command or a small configuration file, depending on which assistant they use. No separate install step is required since the tool is fetched automatically when it first runs. It can also run locally on a person's own computer, or be hosted remotely so it can be reached from Claude in a web browser or on mobile, since those versions cannot run a local server directly. The server exposes a set of specific actions the assistant can take: checking what activity is currently running, listing the names of activity types, starting or stopping an activity, pausing and resuming one, logging a completed activity after the fact with a specific start and end time, editing notes or tags on an existing entry, and pulling summary reports or raw history for a chosen time period. A person can refer to activities by their everyday name rather than an internal code, and the assistant will ask for clarification if a name is ambiguous. In practice this means a person can simply say things like start tracking work, I actually began the meeting at two o'clock, log two hours of reading from last night, or ask where did my week go, and the assistant translates that into the correct action or report. The project is written in TypeScript, requires Node.js version 20 or newer to run from source, and is distributed as a published npm package for the simplest setup path.

Yoink these prompts

Prompt 1
Show me how to register atimelogger-mcp with Claude Code using my personal access token.
Prompt 2
Explain the difference between running this MCP server locally over stdio versus as a remote connector.
Prompt 3
Write a Docker setup that hosts atimelogger-mcp behind an HTTPS proxy for use with claude.ai in the browser.
Prompt 4
What tools does this MCP server expose for starting, stopping, and logging activities?
Prompt 5
Help me troubleshoot a 401 error from atimelogger-mcp's tools.

Frequently asked questions

wtf is atimelogger-mcp?

An MCP server that connects the ATimeLogger time tracking app to AI assistants, letting you start, stop, log, and report on activities through plain conversation.

What language is atimelogger-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

Who is atimelogger-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.