mcp-time logo

mcp-time

by dandeliongold

An MCP server for getting the current time in ISO format using JavaScript Date. This server works with the Claude desktop app on both Windows and macOS.

View on GitHub

Last updated: N/A

What is mcp-time?

This is an MCP server designed to provide time-related functionalities, specifically for use with the Claude desktop application. It offers methods to retrieve the current time in ISO format and calculate time differences between timestamps.

How to use mcp-time?

Install the package using npm install @dandeliongold/mcp-time. Add the server configuration to your claude_desktop_config.json file as shown in the README. Then, you can use the getCurrentTime and getTimeDifference methods via JSON-RPC requests.

Key features of mcp-time

  • Get current time in YYYY-MM-DD HH:mm:ss format

  • Calculate time differences between timestamps and current time

  • Intuitive positive/negative values for future/past times

  • Support for both minutes and seconds intervals

  • Cross-platform support for Windows and macOS

  • Simple JSON-RPC interface

  • Consistent ISO-style date formatting

  • Error handling with detailed error messages

Use cases of mcp-time

  • Displaying current time in Claude desktop app

  • Calculating time remaining for deadlines

  • Determining the age of a timestamp

  • Scheduling tasks based on time differences

FAQ from mcp-time

What is the format of the timestamp?

The timestamp should be in ISO format: YYYY-MM-DD HH:mm:ss

What happens if the timestamp format is incorrect?

The server will return an error message indicating an invalid timestamp format.

What intervals are supported for time difference calculation?

The server supports 'minutes' and 'seconds' intervals.

How does the time difference calculation handle timezones?

The time difference is calculated based on the server's local time. Timezone conversions are not handled automatically.

Is this server compatible with other MCP clients?

While designed for Claude, it should be compatible with any MCP client that supports JSON-RPC.