Manage and Convert Time Across Timezones
MCP server providing tools to get current time in any timezone and convert times between timezones using the IANA timezone database.
Why it matters
Effortlessly manage time-sensitive operations and cross-regional scheduling by accurately retrieving current times and converting between timezones.
Outcomes
What it gets done
Get current time in any specified IANA timezone.
Convert times between different source and target timezones.
Utilize IANA timezone database for accurate conversions.
Integrate with scheduling and time-sensitive automation tasks.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-time | bash Capabilities
Tools your agent gets
Get the current time in a specific timezone with ISO 8601 format and offset information.
Convert time between two timezones using IANA timezone names.
Overview
Time MCP
The Time MCP server provides two tools: get_current_time retrieves the current time in any IANA timezone, and convert_time converts times between different timezones. Both tools return ISO 8601 formatted datetimes with timezone offset information. Use this server when you need to query current times in different timezones or convert times between regions. It's designed for time-sensitive operations and working across different geographical locations. Do not use it for date arithmetic, recurring events, or calendar management - it only handles timezone queries and conversions.
What it does
The Time MCP server exposes two tools that enable AI assistants to work with time and timezones. It retrieves the current time in any IANA timezone and converts times between different timezones, returning ISO 8601 formatted datetimes with timezone offset information.
When to use - and when NOT to
Use this connector when you need to schedule meetings across regions, answer time-sensitive questions about current time in different locations, or convert appointment times between timezones. It's useful for coordinating international teams, planning global events, or building scheduling workflows.
Do NOT use this for date arithmetic (adding days/months), recurring event calculations, or calendar management - it only handles timezone queries and conversions, not date manipulation or scheduling logic.
Inputs and outputs
For get_current_time, you provide an optional IANA timezone name (e.g., "America/New_York", "Europe/London"). The tool returns the current time in that timezone as an ISO 8601 formatted datetime with timezone offset information.
For convert_time, you provide a source timezone, a time in ISO 8601 format, and a target timezone. The tool returns the converted time in the target timezone.
Configuration
Add to your Claude Code settings:
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time"]
}
}
}
You can optionally specify a local timezone:
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time", "--local-timezone", "America/New_York"]
}
}
}
Installation
Using uvx (recommended):
uvx mcp-server-time
Using pip:
pip install mcp-server-time
Usage Example
The server can answer questions like "What time is it in Tokyo right now?" or "If it's 3pm in New York, what time is that in London?"
The server uses the IANA timezone database, supporting zones like America/New_York (Eastern Time), America/Los_Angeles (Pacific Time), Europe/London (GMT/BST), Europe/Paris (Central European Time), Asia/Tokyo (Japan Standard Time), Asia/Shanghai (China Standard Time), and Australia/Sydney (Australian Eastern Time).
Source README
The Time MCP server provides tools for getting the current time and converting between timezones. It's useful for scheduling, time-sensitive operations, and working across different regions.
Installation
Using uvx (recommended):
uvx mcp-server-time
Using pip:
pip install mcp-server-time
Configuration
Add to your Claude Code settings:
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time"]
}
}
}
With Local Timezone
{
"mcpServers": {
"time": {
"command": "uvx",
"args": ["mcp-server-time", "--local-timezone", "America/New_York"]
}
}
}
Available Tools
get_current_time
Get the current time in a specific timezone.
get_current_time(timezone?: string): TimeResult
Parameters:
timezone- IANA timezone name (e.g., "America/New_York", "Europe/London")
Returns:
- Current time in the specified timezone
- ISO 8601 formatted datetime
- Timezone offset information
convert_time
Convert time between timezones.
convert_time(
source_timezone: string,
time: string,
target_timezone: string
): ConversionResult
Parameters:
source_timezone- Source IANA timezonetime- Time to convert (ISO 8601 format)target_timezone- Target IANA timezone
Supported Timezones
Uses IANA timezone database. Common examples:
America/New_York- Eastern TimeAmerica/Los_Angeles- Pacific TimeEurope/London- GMT/BSTEurope/Paris- Central European TimeAsia/Tokyo- Japan Standard TimeAsia/Shanghai- China Standard TimeAustralia/Sydney- Australian Eastern Time
Usage Example
Claude, what time is it in Tokyo right now?
Also, if it's 3pm in New York, what time is that in London?
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.