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.
Basic information
More Other MCP servers
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Activepieces
activepiecesAI 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
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Comments