The Time Tools MCP Server provides various time manipulation functionalities, including:
- Get the current date and time in
YYYY-MM-DD HH:mm:ss
format - Get the current date and time in ISO 8601 format
- Retrieve the current Unix timestamp
- Get the server's current timezone
- Convert Unix timestamps to formatted datetime strings and vice versa
- Calculate the difference between two datetime strings in various units (second, minute, or hour)
Used to translate prompts and content between languages, as evidenced by the example that mentions 'Translated with DeepL.com (free version)' and includes both English and Japanese versions of the same prompt.
Provides image hosting for documentation screenshots, as shown by the GitHub user-attachments URLs in the image references.
Used for package management and running the MCP server, with commands provided for installation (pnpm install), building (pnpm build), and running the server (pnpm start).
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
- eg
get_unixtime
Get the current Unix timestamp (seconds since epoch).
- Returns:
text
: The Unix timestamp as a string.- e.g.
1746627290
- e.g.
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
- e.g.
timezone
(string
, optional): The timezone to use (default: server's timezone).- eg
Asia/Tokyo
- eg
isISO
(boolean
, optional): If true, returns ISO 8601 format; otherwise, returnsYYYY-MM-DD HH:mm:ss
.- eg
true
- eg
- Returns:
text
: The formatted datetime string.- eg
2025-01-01 01:01:01
or2025-01-01T01:01:01+09:00
- eg
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
- eg
timezone
(string
, optional): The timezone to use (default: server's timezone).- eg
Asia/Tokyo
- eg
- Returns:
text
: The Unix timestamp as a string.- e.g.
1746627290000
- e.g.
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
- eg
- Returns:
text
: The formatted current date and time.- eg
2025-01-01 01:01:01
- eg
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
- eg
- Returns:
text
: The ISO 8601 formatted current date and time.- eg
2025-05-07T23:03:27+09:00
- eg
get_elapsed_time
Calculate the difference between two datetime strings.
- Parameters:
from
(string
, required): The start datetime.- eg
2025-01-01 01:01:01
- eg
to
(string
, required): The end datetime.- eg
2025-01-02 02:02:02
- eg
unit
("millisecond" | "second" | "minute" | "hour" | "day" | "week" | "month" | "year"
, optional, default:"second"
): The unit for the difference.- e.g.
"hour"
- e.g.
- Returns:
text
: The difference between the two datetimes in the specified unit.- eg
3600
- eg
Prepare mcp server app
1. Install packages
2. Build
Mcp Inspector
Inspector - Model Context Protocol
get_current_date_time
get_elapsed_time
VS Code
When managed in a project
.vscode/mcp.json
For personal global management
~/Library/Application Support/Code/User/settings.json
Example prompt
en
en
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server for time manipulation tasks, enabling AI models to get the current date/time and calculate duration between timestamps.
Related MCP Servers
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -2Python
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.Last updated -1810TypeScript
- -securityFlicense-qualityA Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.Last updated -1TypeScript
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.Last updated -15TypeScriptMIT License