MCP Connector

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.


90
Spark score
out of 100
Updated 7 months ago
Version 1.0.0
Models
universal

Add to Favorites

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

01

Get current time in any specified IANA timezone.

02

Convert times between different source and target timezones.

03

Utilize IANA timezone database for accurate conversions.

04

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_current_time

Get the current time in a specific timezone with ISO 8601 format and offset information.

convert_time

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 timezone
  • time - Time to convert (ISO 8601 format)
  • target_timezone - Target IANA timezone

Supported Timezones

Uses IANA timezone database. Common examples:

  • 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
  • Australia/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.