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.- e.g.
Asia/Tokyo
- e.g.
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).- e.g.
Asia/Tokyo
- e.g.
isISO
(boolean
, optional): If true, returns ISO 8601 format; otherwise, returnsYYYY-MM-DD HH:mm:ss
.- e.g.
true
- e.g.
- Returns:
text
: The formatted datetime string.- e.g.
2025-01-01 01:01:01
or2025-01-01T01:01:01+09:00
- e.g.
convert_datetime_to_unix
Convert a datetime string to a Unix timestamp (milliseconds since epoch).
- Parameters:
time
(string
, required): The datetime string to convert.- e.g.
2025-01-01 01:01:01
- e.g.
timezone
(string
, optional): The timezone to use (default: server's timezone).- e.g.
Asia/Tokyo
- e.g.
- 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).- e.g.
Asia/Tokyo
- e.g.
- Returns:
text
: The formatted current date and time.- e.g.
2025-01-01 01:01:01
- e.g.
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).- e.g.
Asia/Tokyo
- e.g.
- Returns:
text
: The ISO 8601 formatted current date and time.- e.g.
2025-05-07T23:03:27+09:00
- e.g.
get_elapsed_time
Calculate the difference between two datetime strings.
- Parameters:
from
(string
, required): The start datetime.- e.g.
2025-01-01 01:01:01
- e.g.
to
(string
, required): The end datetime.- e.g.
2025-01-02 02:02:02
- e.g.
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.- e.g.
3600
- e.g.
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
jp
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