TimeMCP logo

TimeMCP

by chew-z

TimeMCP is a simple Model Control Protocol (MCP) server that provides time and timezone conversion tools. It allows users to get the current time in a specific timezone or convert time between different timezones.

View on GitHub

Last updated: N/A

What is TimeMCP?

TimeMCP is a Model Control Protocol (MCP) server designed for time and timezone management. It offers functionalities to retrieve the current time in various timezones and convert time between different timezones.

How to use TimeMCP?

To use TimeMCP, first build the server using go build -o ./bin/mcp-time .. Then, add it to your claude_desktop_config.json file with the correct path to the executable. Finally, use an MCP-compatible client to discover and call the available tools with appropriate arguments.

Key features of TimeMCP

  • Get current time in a specific timezone

  • Convert time between different timezones

  • Supports IANA time zone database

  • Implements Model Control Protocol

  • Easy to integrate with MCP-compatible clients

Use cases of TimeMCP

  • Displaying current time in different locations

  • Scheduling events across multiple timezones

  • Converting logs to a specific timezone

  • Integrating time conversion into applications

  • Automating time-related tasks

FAQ from TimeMCP

What timezones are supported?

The server supports all IANA time zone database entries, such as Europe/Warsaw, America/New_York, and Asia/Tokyo.

What is the default timezone if none is provided?

If no timezone is provided, the server uses the system timezone.

What format should the time be in?

The time should be in 24-hour format (HH:MM).

What is MCP?

MCP stands for Model Control Protocol. It is a protocol that allows clients to discover and call tools on a server.

What dependencies are required?

The server depends on github.com/mark3labs/mcp-go for the MCP implementation and github.com/araddon/dateparse for flexible date parsing.