README.md
MCP Time Server
A free, hosted MCP server providing accurate time and timezone tools for Claude Code — including remote /cowork sessions.
Quick Setup
claude mcp add --transport http time-server https://oss-mcp-time.onrender.com/mcp
With timezone hint (recommended):
claude mcp add --transport http \
--header "X-Timezone: America/New_York" \
time-server https://oss-mcp-time.onrender.com/mcp
Replace America/New_York with your IANA timezone.
Available Tools
`get_current_time`
Returns current time, date, UTC offset, and DST status for any IANA timezone.
Parameters:
| Parameter | Required | Description |
|---|---|---|
timezone |
Yes | IANA timezone string (e.g., America/New_York) |
Example response:
{
"datetime": "2026-03-02T14:30:00",
"timezone": "America/New_York",
"utc_offset": "-05:00",
"is_dst": false
}
`convert_time`
Converts a time from one timezone to another.
Parameters:
| Parameter | Required | Description |
|---|---|---|
source_timezone |
Yes | Source IANA timezone |
time |
Yes | Time in HH:MM format |
target_timezone |
Yes | Target IANA timezone |
date |
No | Date in YYYY-MM-DD format (defaults to today) |
Example response:
{
"source": "14:00",
"target": "19:00",
"source_timezone": "America/New_York",
"target_timezone": "Europe/London",
"utc_offset_source": "-05:00",
"utc_offset_target": "+00:00"
}
Why?
Claude Code /cowork (remote) sessions run on Anthropic's infrastructure, not your machine. Local MCP servers like mcp-server-time aren't accessible. This hosted server solves that.
Self-Hosting
git clone https://github.com/YOUR_USERNAME/oss-mcp-time.git
cd oss-mcp-time
npm install
npm run build
npm start
License
MIT
Tools 2
get_current_timeReturns current time, date, UTC offset, and DST status for any IANA timezone.convert_timeConverts a time from one timezone to another.Try it
→What is the current time and date in Tokyo?
→Convert 14:00 from America/New_York to Europe/London.
→Check if daylight savings is currently active in Sydney.
→What time will it be in Los Angeles when it is 09:00 in Berlin tomorrow?