home / mcp / time mcp server

Time MCP Server

Provides time-aware MCP tools for current time, relative time, date calculations, and timezone conversions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cultrix-github-mcp-timeserver": {
      "url": "https://mcp-timeserver.<your-account>.workers.dev/mcp"
    }
  }
}

You run a remote MCP server that exposes a time toolkit for models: current time, relative time, days in a month, timestamps, timezone conversions, and week numbers. It helps AI systems stay aware of time across UTC and local zones, making time-based reasoning and scheduling more reliable.

How to use

Connect to the MCP server from your MCP client and call the available tools to get time data. The server provides a complete set of time-related functions that you can request with your model calls. Use the server as a remote source of time information to enrich conversations, scheduling tasks, and date calculations.

How to install

Prerequisites: Node.js installed on your machine. You may also want a Cloudflare account if you plan to deploy to Workers.

Option A — Deploy to Cloudflare Workers from a project you own:

{
  "name": "time_mcp",
  "type": "http",
  "url": "https://mcp-timeserver.<your-account>.workers.dev/mcp",
  "args": []
}

Option B — Create locally from a Cloudflare template and run the server locally for testing (or development):

npm create cloudflare@latest -- mcp-timeserver --template=cloudflare/ai/demos/remote-mcp-authless
```
```bash
npm install dayjs

Additional sections

Configuration and deployment details are provided below to help you run, test, and connect to the time MCP server.

Notes

- The server runs as a remote MCP endpoint, exposing time-related tools over the MCP protocol. - You can test locally via the SSE transport at http://localhost:8787/sse or the HTTP transport at http://localhost:8787/mcp when running in dev mode.

Security and access

If you are deploying publicly, consider enabling authentication options offered by your hosting platform and restricting access to trusted clients. For development, keep tokens and keys out of client-side code and use secure channels for all MCP calls.

Available tools

current_time

Get the current time in UTC and in a target timezone, formatted as requested.

relative_time

Compute the relative time from now for a given timestamp, such as 2 days from now or 3 hours ago.

days_in_month

Return the number of days in a specified month or the current month if no date is given.

get_timestamp

Obtain the Unix timestamp in milliseconds for a given time or for now.

convert_time

Convert a time between two IANA time zones, preserving a specific moment.

get_week_year

Return the week number and ISO week for a given date or for today.