Skip to main content
Glama
deenesjakoruzh

Time Tools MCP Server

by t-shiratori
GitHub
TypeScript
MIT License
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP server for time manipulation

A dynamic MCP server management service for time manipulation.

MCP Tools

This server provides several time-related tools via the Model Context Protocol (MCP).

get_timezone

Get the current timezone of the server.

  • Returns:
    • text : The timezone string.
      • eg Asia/Tokyo

get_unixtime

Get the current Unix timestamp (seconds since epoch).

  • Returns:
    • text : The Unix timestamp as a string.
      • e.g. 1746627290

convert_unix_to_datetime

Convert a Unix timestamp to a formatted datetime string.

  • Parameters:
    • unixtime ( number , required): The Unix timestamp to convert.
      • e.g. 1746627290
    • timezone ( string , optional): The timezone to use (default: server's timezone).
      • eg Asia/Tokyo
    • isISO ( boolean , optional): If true, returns ISO 8601 format; otherwise, returns YYYY-MM-DD HH:mm:ss .
      • eg true
  • Returns:
    • text : The formatted datetime string.
      • eg 2025-01-01 01:01:01 or 2025-01-01T01:01:01+09:00

convert_datetime_to_unix

Convert a datetime string to a Unix timestamp (milliseconds since epoch).

  • Parameters:
    • time ( string , required): The datetime string to convert.
      • eg 2025-01-01 01:01:01
    • timezone ( string , optional): The timezone to use (default: server's timezone).
      • eg Asia/Tokyo
  • Returns:
    • text : The Unix timestamp as a string.
      • e.g. 1746627290000

get_current_date_time

Get the current date and time in YYYY-MM-DD HH:mm:ss format.

  • Parameters:
    • timezone ( string , optional): The timezone to use (default: server's timezone).
      • eg Asia/Tokyo
  • Returns:
    • text : The formatted current date and time.
      • eg 2025-01-01 01:01:01

get_current_date_time_iso

Get the current date and time in ISO 8601 format.

  • Parameters:
    • timezone ( string , optional): The timezone to use (default: server's timezone).
      • eg Asia/Tokyo
  • Returns:
    • text : The ISO 8601 formatted current date and time.
      • eg 2025-05-07T23:03:27+09:00

get_elapsed_time

Calculate the difference between two datetime strings.

  • Parameters:
    • from ( string , required): The start datetime.
      • eg 2025-01-01 01:01:01
    • to ( string , required): The end datetime.
      • eg 2025-01-02 02:02:02
    • unit ( "millisecond" | "second" | "minute" | "hour" | "day" | "week" | "month" | "year" , optional, default: "second" ): The unit for the difference.
      • e.g. "hour"
  • Returns:
    • text : The difference between the two datetimes in the specified unit.
      • eg 3600

Prepare mcp server app

1. Install packages

pnpm install

2. Build

pnpm build

Mcp Inspector

Inspector - Model Context Protocol

pnpm inspect

get_current_date_time

get_elapsed_time

VS Code

When managed in a project

.vscode/mcp.json

{ "servers": { "time-tools": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"] } } }

For personal global management

~/Library/Application Support/Code/User/settings.json

{ "mcp": { "servers": { "time-tools": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"] } } } }

Example prompt

en

## Overview - Please perform the following tasks - Perform the following tasks and measure the time it takes to perform the tasks. - Please follow the time tracking requirements for the measurement method ## Tasks - Create the src directory - Create an empty file in it - Name the file index.ts ## Time tracking requirements 1. retrieve and display the current time before the task starts 2. 2. retrieve and display the current time after the task is completed 3. 3. retrieve and display the elapsed time from the start and end time of the task 4. finally display the following table 4. finally display in the following table format |item|record| |:---|:---| |start time|<enter result>| |end time|<enter result>| |elapsed time|<enter result>|

en

## 概要 - 以下のタスクを実行してください - タスク実行に要した時間も計測します - 計測の方法はタイムトラッキング要件にしたがってください ## タスク - src ディレクトリを作成する - その中に空のファイルを作成する - 作成するファイル名は index.ts とする ## タイムトラッキング要件 1. タスク開始前の現在時間を取得して表示する 2. タスク終了後の現在時間を取得して表示する 3. タスクの開始時と終了時の時間から経過時間を取得して表示する 4. 最終的に以下の表形式で表示してください |項目|記録| |:---|:---| |開始時間|<結果を入力>| |終了時間|<結果を入力>| |経過時間|<結果を入力>|
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Model Context Protocol server for time manipulation tasks, enabling AI models to get the current date/time and calculate duration between timestamps.

  1. MCP Tools
    1. get_timezone
    2. get_unixtime
    3. convert_unix_to_datetime
    4. convert_datetime_to_unix
    5. get_current_date_time
    6. get_current_date_time_iso
    7. get_elapsed_time
  2. Prepare mcp server app
    1. 1. Install packages
    2. 2. Build
  3. Mcp Inspector
    1. VS Code
      1. When managed in a project
      2. For personal global management
    2. Example prompt

      Related MCP Servers

      • Time MCP Server

        ConechoAI
        A
        security
        F
        license
        A
        quality
        A Model Context Protocol server that provides time and timezone conversion capabilities, enabling LLMs to get current time information and perform timezone conversions using IANA timezone names.
        Last updated -
        2
        1
        Python

      • DateTime MCP Server

        TakanariShimbo
        A
        security
        F
        license
        A
        quality
        A Model Context Protocol server that provides tools to get the current date and time in various formats, supporting different timezones and custom formatting options.
        Last updated -
        1
        9
        JavaScript

      • TimeCamp MCP Serverofficial

        timecamp-org
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that provides time tracking integration with TimeCamp, allowing AI assistants to create, retrieve, update, and delete time entries through natural language commands.
        Last updated -
        TypeScript

      • Time MCP Server

        ssinha3
        A
        security
        F
        license
        A
        quality
        A Model Context Protocol server that provides time and timezone conversion capabilities, enabling LLMs to get current time information and perform timezone conversions using IANA timezone names.
        Last updated -
        2
        Python

      View all related MCP servers

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/t-shiratori/time-tools-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server