# atimelogger-mcp

Connects ATimeLogger to an AI assistant for timers, past entries, activity notes, and time reports. Useful when time tracking should happen through chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Author: zaplitny
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zaplitny/atimelogger-mcp
- Updated: 2026-08-20
- HTML: https://affpapa.org/en/nevibecode/mcp/atimelogger-mcp

## What it does

atimelogger-mcp exposes ATimeLogger’s REST API through MCP. An assistant can start, stop, pause, and resume activities, record completed intervals, edit tags or comments, inspect the active timer, and query history. Reports aggregate time by activity type and period.

Activity names are matched against the account’s type list, so a shortened name can still target the right type when it is unambiguous. Results include readable durations and use the ATimeLogger timezone unless another timezone is supplied. The `app_help` tool lets the assistant consult the app’s documentation.

Node 20+ and an ATimeLogger Personal Access Token are required. Put the token in `ATL_TOKEN`; it is displayed only once when generated, so save it immediately.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ATL_TOKEN`, `ATL_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ATL_TOKEN=<ATL_TOKEN> --env ATL_BASE_URL=<ATL_BASE_URL> --transport stdio atimelogger-mcp -- npx -y atimelogger-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add atimelogger-mcp --env ATL_TOKEN=<ATL_TOKEN> --env ATL_BASE_URL=<ATL_BASE_URL> -- npx -y atimelogger-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atimelogger-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "atimelogger-mcp"
            ],
            "env": {
                "ATL_TOKEN": "<ATL_TOKEN>",
                "ATL_BASE_URL": "<ATL_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atimelogger-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "atimelogger-mcp"
            ],
            "env": {
                "ATL_TOKEN": "<ATL_TOKEN>",
                "ATL_BASE_URL": "<ATL_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ATL_TOKEN=<ATL_TOKEN> -e ATL_BASE_URL=<ATL_BASE_URL> atimelogger-mcp npx -y atimelogger-mcp
```
Replace <…> with your own values

## When to use it
- start a timer for an activity
- record a missed interval from earlier
- break down tracked time by period
- inspect a day from the activity history
- update an entry’s tags or comment

## Example prompts
- Start tracking the “Work” activity and show the current status.
- Log yesterday’s reading session from 9:00 to 11:00.
- Compare sleep time for this month with last month.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md