# mcp-time [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/mcpcentral-io/mcp-time  
**GitHub Stars:** 3  
**npm Downloads (last month):** 3577  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-time

## Description
Time MCP server via HTTP

## Tools
Capabilities this server exposes over MCP:

- **current_time** — Returns the current time in UTC and a specified or guessed IANA timezone.
- **relative_time** — Calculates the relative time from now to a given date-time string.
- **days_in_month** — Returns the number of days in the month of a given date.
- **get_timestamp** — Converts a date-time string to a Unix timestamp in milliseconds.
- **convert_time** — Converts a time from a source IANA timezone to a target IANA timezone.
- **get_week_year** — Returns the week number and ISO week number for a given date.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-time": {
    "command": "npx",
    "args": ["-y","@mcpcentral/mcp-time"]
  }
}
```

## Documentation

## What mcp-time does

The mcp-time MCP server exposes six date and time operations to MCP-compatible clients. It can retrieve the current date and time using a requested timezone and format, produce human-readable relative descriptions such as time remaining or elapsed time, and determine the number of days in a specified month and year.

The remaining tools handle common conversions and calendar values. `get_timestamp` converts a supplied time into a Unix timestamp in milliseconds. `convert_time` changes a time between IANA timezones. `get_week_year` returns the week number and ISO week number for a date.

These capabilities suit agents that need to answer timezone questions, normalize date values, perform basic calendar checks, or prepare timestamps for other operations.

## How it works

The mcp-time MCP server supports two transports. In stdio mode, an MCP client launches the npm package locally and communicates with the process. The package can be installed globally with npm or run on demand with `npx @mcpcentral/mcp-time`.

In Streamable HTTP mode, a client connects to the deployed Cloudflare Worker at `https://mcp.time.mcpcentral.io`, or to another Worker deployment. The HTTP configuration uses the server URL and the `streamable-http` transport.

The project is implemented in TypeScript, with `src/index.ts` serving as the Cloudflare Worker entry point and containing the MCP logic. Local development can run the HTTP version through Wrangler on port 8787.

## Setup and configuration

For local use, install the package globally or invoke it with `npx`. An MCP client configuration can launch the package with `npx` and the package name, or point to the installed executable. The README gives Claude Desktop as an example of a local stdio client.

For remote use, configure the client with the deployed URL and set the transport to Streamable HTTP. No environment variables are documented as required for the published local or remote connection examples.

Developers building from source can clone the repository, run `npm install`, and compile it with `npm run build`. Running `npx wrangler dev` starts a local HTTP endpoint. The project can be deployed to Cloudflare Workers with Wrangler after configuring the Worker deployment file, and the package can be published to npm after building it.

## Tools and capabilities

The mcp-time MCP server provides these tools:

- `current_time`: returns the current time for a specified timezone and format.
- `relative_time`: creates a human-readable relative time string from a supplied time.
- `days_in_month`: reports the number of days in a given month and year.
- `get_timestamp`: converts a time into Unix milliseconds.
- `convert_time`: converts a time between IANA timezones.
- `get_week_year`: returns week and ISO week values for a date.

The repository includes command-line examples for initializing the stdio server and calling `current_time`. MCP Inspector, MCPCentral Lab, and MCPCentral Inspector are listed as options for testing the HTTP endpoint.

## Limitations and notes

The mcp-time MCP server is limited to the six documented date and time operations. Remote deployments use Cloudflare Workers, while local stdio use requires Node.js tooling such as npm or npx.

The HTTP examples also show that Anthropic's MCP Connector and OpenAI's Agents SDK can connect to Streamable HTTP servers. Microsoft Copilot Studio support is described through a custom connector and its MCP tool configuration. These are connection options documented by the project rather than additional tools supplied by the server.

_Full upstream README: https://allmcps.com/mcp/mcp-time/readme_