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