mcp-timer-server

A Model Context Protocol (MCP) server that provides accurate system time to LLM applications via a simple tool call.

Features

• Real-time data: Provides the current date and time from the host machine
• Multi-timezone support: Query time in any supported IANA timezone
• Zero dependencies at runtime: Uses only Node.js built-in Intl API
• Stdio transport: Works with any MCP-compatible client

Installation

Clone and install locally:

git clone https://github.com/scotty-phillips/mcp-timer-server.git
cd mcp-timer-server
npm install

Usage with LM Studio

1. Open LM Studio and go to the Developer tab (MCP section)

2. Add a new MCP server configuration pointing to your local installation:

{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:\\Users\\scott\\system-time-mcp\\index.js"]
    }
  }
}

Note: Update the path to match where you clone the repo. Use forward slashes or escape backslashes in Windows paths.

Available Tools

get_system_time

Returns the current accurate system date and time from the local workstation.

Input Parameters: None required.

Example Response:

The current time on this workstation is: Wednesday, June 13, 2026, 7:05 PM (Australian Eastern Summer Time)

Note: For timezone-aware time with more IANA timezone options, use the enhanced version at src/index.js which supports a timezone parameter.

Usage with Other Clients

For other MCP-compatible clients, point the server configuration to your local node executable and the path to index.js.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:/path/to/system-time-mcp/src/index.js"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "timer": {
      "command": "node",
      "args": ["C:/path/to/system-time-mcp/src/index.js"]
    }
  }
}

Development

Running Locally

npm start

Running Tests

npm test

Help

The server runs via stdio and responds to tool calls from any MCP client.

Project Structure

mcp-timer-server/
├── src/
│   └── index.js      # Enhanced version with timezone support
├── tests/
│   └── index.test.js # Basic test suite
├── .gitignore
├── LICENSE
├── README.md
└── package.json

License

MIT - Copyright (c) 2026 Scott Phillips

Author

Scott Phillips
GitHub: scotty-phillips