@dandeliongold/mcp-time
Description
# @dandeliongold/mcp-time An MCP server for getting current time in ISO format (YYYY-MM-DD HH:mm:ss) using JavaScript Date. This server works with the Claude desktop app on both Windows and macOS. ## Components ### Tools 1. `getCurrentTime` - Returns the current time in ISO…
About
# @dandeliongold/mcp-time An MCP server for getting current time in ISO format (YYYY-MM-DD HH:mm:ss) using JavaScript Date. This server works with the Claude desktop app on both Windows and macOS. ## Components ### Tools 1. `getCurrentTime` - Returns the current time in ISO format - No input parameters required -…
Details
- Author
- dandeliongold
- Downloads
- 205
- Categories
- Productivity
Jump to
- Get current time in YYYY-MM-DD HH:mm:ss format.
- Calculate time differences between timestamps and current time.
- Intuitive positive/negative values for future/past times.
- Support for both minutes and seconds intervals.
- Cross-platform support for Windows and macOS.
- Simple JSON-RPC interface with error handling.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
@dandeliongold/mcp-timeCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package via npm (npm install @dandeliongold/mcp-time), then add it to your claude_desktop_config.json with the command npx @dandeliongold/mcp-time. The server exposes two tools: getCurrentTime (no parameters) and getTimeDifference (requires a timestamp and optional interval of minutes or seconds).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"@dandeliongold/mcp-time": {
"time": {
"command": "npx",
"args": [
"@dandeliongold/mcp-time"
]
}
}
}
}McpServers
{
"time": {
"command": "npx",
"args": [
"@dandeliongold/mcp-time"
]
}
}@dandeliongold/mcp-time
An MCP server for getting current time in ISO format (YYYY-MM-DD HH:mm:ss) using JavaScript Date. This server works with the Claude desktop app on both Windows and macOS.
Components
Tools
1. getCurrentTime
- Returns the current time in ISO format
- No input parameters required
- Returns:
{
"time": "2024-02-08 11:04:33",
"success": true
}
Example JSON-RPC request:
{
"jsonrpc": "2.0",
"id": 1,
"method": "getCurrentTime"
}
Example JSON-RPC response:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"time": "2024-02-08 11:04:33",
"success": true
}
}
2. getTimeDifference
- Calculates the time difference between a given timestamp and the current time
- Parameters:
- timestamp: ISO format timestamp (YYYY-MM-DD HH:mm:ss)
- interval: 'minutes' (default) or 'seconds'
- Returns a signed difference value following this convention:
- Positive values (+) indicate future timestamps ("in X minutes/seconds")
- Negative values (-) indicate past timestamps ("X minutes/seconds ago")
- Zero (0) indicates same timestamp
Example JSON-RPC request:
{
"jsonrpc": "2.0",
"id": 1,
"method": "getTimeDifference",
"params": {
"timestamp": "2024-02-08 12:30:00",
"interval": "minutes"
}
}
Example JSON-RPC responses:
// For a past timestamp (30 minutes ago)
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difference": -30,
"interval": "minutes",
"inputTimestamp": "2024-02-08 12:30:00",
"currentTime": "2024-02-08 13:00:00"
}
}
// For a future timestamp (in 45 minutes)
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"difference": 45,
"interval": "minutes",
"inputTimestamp": "2024-02-08 13:45:00",
"currentTime": "2024-02-08 13:00:00"
}
}
Features
- Get current time in YYYY-MM-DD HH:mm:ss format
- Calculate time differences between timestamps and current time
- Intuitive positive/negative values for future/past times
- Support for both minutes and seconds intervals
- Cross-platform support for Windows and macOS
- Simple JSON-RPC interface
- Consistent ISO-style date formatting
- Error handling with detailed error messages
Installation
npm install @dandeliongold/mcp-time
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"time": {
"command": "npx",
"args": [
"@dandeliongold/mcp-time"
]
}
}
}
Development
1. Clone the repository
2. Install dependencies
npm install
3. Run tests
npm test
4. Start development server
npm run dev
License
MIT License - see LICENSE for details
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
