TimeTagger MCP Server logo

TimeTagger MCP Server

by regismesquita

The TimeTagger MCP Server provides an interface for interacting with TimeTagger through Claude or other MCP-compatible AI assistants. It allows users to query, manage, and analyze their time records.

View on GitHub

Last updated: N/A

What is TimeTagger MCP Server?

The TimeTagger MCP Server is a Model Context Protocol (MCP) server designed to facilitate interaction with the TimeTagger time tracking application. It enables users to manage their time records, retrieve summaries, and adjust settings using AI assistants like Claude.

How to use TimeTagger MCP Server?

The server can be installed manually or via Claude Desktop. Manual installation involves installing dependencies using uv and setting the TimeTagger API key as an environment variable. For Claude Desktop, add the provided configuration to the claude_desktop_config.json file. Once installed, you can interact with TimeTagger through the available tools and resources.

Key features of TimeTagger MCP Server

  • Query time records within specific timeframes

  • Create, update, and delete time records

  • Get time summaries by tags

  • Start and stop timers

  • Manage TimeTagger settings

  • Integration with Claude and other MCP-compatible AI assistants

Use cases of TimeTagger MCP Server

  • Automated time tracking management through AI assistants

  • Generating time reports and summaries using natural language queries

  • Updating time records and settings via voice commands

  • Integrating time tracking data with other applications and services

FAQ from TimeTagger MCP Server

How do I install the server?

You can install it manually using uv and setting environment variables, or through Claude Desktop by adding the provided configuration.

What is the purpose of the API key?

The API key is required to authenticate with your TimeTagger instance and access your time records.

How do I query time records?

You can use the get_records, get_recent_records, and get_today_records tools to retrieve records within specific time ranges.

Can I update TimeTagger settings through the server?

Yes, you can use the get_settings and update_setting tools to manage TimeTagger settings.

What are the available resources?

The available resources include timetagger://config, timetagger://records/{timerange}, timetagger://settings, and timetagger://updates/{since}.