Skip to main content
Glama
williamlang

Date-Time MCP Server

by williamlang
README.md
# Date-Time MCP Server

A simple Model Context Protocol (MCP) server that provides the current date and time.

## Features

- Returns current date and time in ISO 8601 format
- Includes Unix timestamp
- Provides timezone information
- Returns human-readable formatted date/time

## Installation

```bash
npm install
npm run build
```

## Usage

### With Claude Desktop

Add this to your Claude Desktop configuration file:

**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "date-time": {
      "command": "node",
      "args": ["/absolute/path/to/date-time-mcp/build/index.js"]
    }
  }
}
```

### Testing

You can test the server using the MCP Inspector or any MCP client.

## Available Tools

### get_current_datetime

Returns the current date and time information.

**Parameters**: None

**Returns**:
```json
{
  "datetime": "2025-12-08T16:57:00.000Z",
  "timestamp": 1733676420000,
  "timezone": "America/New_York",
  "formatted": "12/8/2025, 11:57:00 AM"
}
```

## Development

```bash
# Build the project
npm run build

# Watch mode for development
npm run watch
```

## License

MIT

TDQS

A4.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap. The tool's purpose is clear and distinct.

Naming Consistency5/5

The single tool name 'get_current_datetime' follows a clear verb_noun pattern, is descriptive, and uses consistent snake_case. There are no other names to conflict with.

Tool Count3/5

A single tool is on the low end of the spectrum. While it covers a basic need, a date-time server might reasonably include more tools (e.g., timezone conversion, formatting), so the count feels slightly thin.

Completeness2/5

The server only provides the current date/time, but a typical date-time utility would also handle conversions, formatting, or timezone lookups. This leaves significant gaps for common use cases.

Maintenance

ActivityInactive
ResponsivenessNo issues