home / mcp / time mcp server

Time MCP Server

Provides current time in ISO format and time differences via MCP forClaude Desktop across Windows and macOS.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dandeliongold-mcp-time": {
      "command": "npx",
      "args": [
        "@dandeliongold/mcp-time"
      ]
    }
  }
}

You can use this MCP server to obtain the current time in a consistent ISO-like format and to compute time differences relative to the present moment. It exposes simple functions you can call from your MCP client to integrate time data into your workflows, automations, or tests across platforms using the Claude desktop app.

How to use

Connect to the time MCP server from your MCP client to fetch the current time or compute differences between a given timestamp and now. Use the time data to timestamp events, schedule actions, or display relative time in your UI. The interface is designed to be straightforward: request the current time when you need a timestamp, or provide a timestamp to see how far away it is from the present moment.

How to install

Prerequisites you need before installation:

Node.js and npm installed on your system
Access to a terminal or shell with network access

Install the MCP Time package from the registry:

npm install @dandeliongold/mcp-time

Usage with Claude Desktop

Configure Claude Desktop to load the MCP server under a time key. This enables you to call the server’s endpoints from the Claude environment as part of your workflows.

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "@dandeliongold/mcp-time"
      ]
    }
  }
}

Available tools

getCurrentTime

Returns the current time in ISO-like format and a success flag. Useful for timestamping and time-based automation.

getTimeDifference

Calculates the time difference between a given ISO timestamp and the current time. Supports minutes or seconds intervals and returns a signed difference indicating future or past timing.