relative_time

MCP tool from MCP Time by TheoBrigitte

Get a time based on a relative natural language expression.

How to use it

relative_time is exposed by the MCP Time MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the relative_time tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install MCP Time

$go install github.com/TheoBrigitte/mcp-time/cmd/mcp-time@latest

FULL MCP TIME LISTING

Other tools in MCP Time (15)

add_time

Add or subtract a duration from a given time.

compare_time

Compare two times and determine their relationship. Supports timezone-aware comparisons.

convert_timezone

Convert a given time between timezones.

current_time

Get the current time in any timezone and format.

duration

(required) - Duration to add/subtract (e.g., 2h30m, -1h, 24h)

format

(optional) - The output format (predefined like RFC3339, Kitchen, or custom Go layout)

input_timezone

(optional) - Timezone of the input time

output_timezone

(optional) - Target timezone for the output

text

(required) - Natural language expression (e.g., yesterday, 5 minutes ago, next month)

time

(optional) - Reference time for the expression. Defaults to current time

time_a

(required) - First time to compare

time_a_timezone

(optional) - Timezone for timea in IANA format (e.g., America/NewYork)

time_b

(required) - Second time to compare

time_b_timezone

(optional) - Timezone for timeb in IANA format (e.g., Europe/London)

timezone

(optional) - Target timezone in IANA format (e.g., America/NewYork). Defaults to UTC