TimeTagger MCP Server

@regismesquita

About TimeTagger MCP Server

A MCP server for the timetagger tool, allowing you to start, stop timers and get reports directly from your MCP Client

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "timetagger": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/regismesquita/timetagger-mcp",
        "timetagger-mcp"
      ],
      "env": {
        "TIMETAGGER_API_KEY": "",
        "TIMETAGGER_API_URL": ""
      }
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is TimeTagger MCP Server?

TimeTagger MCP Server is a Model Context Protocol (MCP) server that allows you to interact with TimeTagger through Claude or other MCP-compatible AI assistants. It provides tools to query, create, update, and hide time records, manage timers, and retrieve time summaries.

How to use TimeTagger MCP Server?

Install by adding the uvx command block to your Claude Desktop configuration with environment variables TIMETAGGER_API_KEY and TIMETAGGER_API_URL. Alternatively, install uv, clone the repository, and run uv pip install -r requirements.txt. For development, use fastmcp dev timetagger_mcp.py to open the MCP Inspector interface.

Key features of TimeTagger MCP Server

Query time records within specific timeframes
Create, update, and hide/delete records
Get time summaries grouped by tags
Start and stop timers
Manage TimeTagger settings
Find records by tag

Use cases of TimeTagger MCP Server

Retrieve all records from the last N hours
Create a new time entry via a chat command
Stop a running timer and log its duration
Summarize time spent on different project tags
Update or hide an existing record

FAQ from TimeTagger MCP Server

What environment variables are required?

You must set TIMETAGGER_API_KEY and TIMETAGGER_API_URL before running the server.

How do I install the server for Claude Desktop?

Add the uvx configuration block shown in the README to your claude_desktop_config.json file and restart Claude.

Can I test the server without Claude?

Yes, run fastmcp dev timetagger_mcp.py to launch the MCP Inspector interface where you can interact with all tools and resources.

What dependencies does the server require?

It depends on Python, uv, and the packages listed in requirements.txt. The recommended runner is uvx, which handles dependencies automatically.

How does authentication work?

The server authenticates with your TimeTagger instance using an API key passed via the TIMETAGGER_API_KEY environment variable.

Frequently asked questions

What environment variables are required?

You must set `TIMETAGGER_API_KEY` and `TIMETAGGER_API_URL` before running the server.

How do I install the server for Claude Desktop?

Add the `uvx` configuration block shown in the README to your `claude_desktop_config.json` file and restart Claude.

Can I test the server without Claude?

Yes, run `fastmcp dev timetagger_mcp.py` to launch the MCP Inspector interface where you can interact with all tools and resources.

What dependencies does the server require?

It depends on Python, `uv`, and the packages listed in `requirements.txt`. The recommended runner is `uvx`, which handles dependencies automatically.

How does authentication work?

The server authenticates with your TimeTagger instance using an API key passed via the `TIMETAGGER_API_KEY` environment variable.

Comments

Basic information

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K