convert_time
Convert time between timezones.
LABSCO SUMMARY
The model stops guessing what time it is.
What it takes off you is the correction afterwards: a model has no clock, so "next Tuesday", "three hours ago" and "which week are we in" get answered from a call rather than from training data — in whichever timezone you name.
What it is
A small time server. Six calls cover the questions a model cannot answer on its own: what time it is now, and how one representation of a time relates to another.
What you get
- The current date and time, in the format and the timezone you ask for
- How far a given time is from now
- A Unix timestamp in milliseconds for a time you name, or for now
- The same instant converted between two timezones
- The number of days in a month, defaulting to the current one
- The week number of the year and the ISO week number
Requirements
npx on your PATH, and nothing else. It runs as a local process, so the clock it reads is that machine's unless you name a timezone in the call.
Setup effort
One command — npx -y time-mcp
USE CASES
01
Resolving "next Tuesday" to a real date
A model has no clock, so anything relative is a guess until something answers. Ask what time it is now, in the timezone that matters, and let the phrase resolve against that.
02
Setting a time that works in two places
Convert the same instant between the two timezones involved and state both, so a meeting written down once does not have to be recalculated by whoever reads it.
03
Working out a deadline that lands on a real day
Month lengths are the usual source of an off-by-one. Ask how many days the month has, take the current date, and let the arithmetic run on values rather than on assumptions.
04
Reporting by week without arguing about which week
Get the week number and the ISO week number together, so a weekly report agrees with whichever definition the rest of the team uses.
05
Stamping records with something you can sort
Turn a time — now, or one you name — into a millisecond timestamp, so what gets written down can be compared and ordered later without parsing a sentence.
6 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
current_time
Get the current date and time.
days_in_month
Get the number of days in a month. If no date is provided, get the number of days in the current month.
get_timestamp
Get the timestamp for the time.
get_week_year
Get the week and isoWeek of the year.
relative_time
Get the relative time from now.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 6 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"time-mcp": {
"command": "npx",
"args": [
"-y",
"time-mcp"
]
}
}
}npx
TERMINAL
npx -y time-mcp
