What is Datetime Mcp

The @pinkpixel/datetime-mcp is a simple MCP server designed to provide language models with the current date and time from the server’s system clock. It operates using TypeScript and demonstrates basic tool implementation for the Model Context Protocol (MCP).

Use cases

This server can be utilized in applications where accurate current date and time information is required, such as scheduling, time-sensitive tasks, event logging, or anywhere time context is necessary for language models in response generation.

How to use

To use the datetime-mcp server, you can install it globally via npm or through Smithery. Configuration involves adding specific settings related to the MCP server in your client’s settings file. After installation and configuration, restart your MCP client to apply changes.

Key features

The main feature is the ‘get_current_datetime’ tool, which outputs the current date and time in ISO 8601 format. It takes no input parameters and provides a straightforward interface for accessing the server’s date and time.

Where to use

This MCP server can be used within any application or system that supports the Model Context Protocol, such as chatbots, virtual assistants, or any AI-driven application that benefits from contextually aware responses involving date and time.

@pinkpixel/datetime-mcp MCP Server ⏰

A simple MCP server that provides LLMs with the current date and time context based on the server’s system clock.

This is a TypeScript-based MCP server that demonstrates a basic tool implementation for the Model Context Protocol.

Features ✨

Tools

• get_current_datetime: Returns the current date and time of the server as an ISO 8601 formatted string (e.g., 2025-04-05T22:30:00.000Z).
  • Takes no input parameters.

Installation 🚀

There are two ways to install and configure this MCP server:

Installing via Smithery

To install datetime-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @pinkpixel-dev/datetime-mcp --client claude

1. Installation from NPM (Recommended)

Install the package globally using npm:

npm install -g @pinkpixel/datetime-mcp

Then, add the following configuration to your MCP client’s settings file.

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/datetime-mcp"
      ],
      "disabled": false,
      "alwaysAllow": [
        "get_current_datetime"
      ]
    }
  }
}

(Restart your MCP client application after updating the settings)

2. Local Development Setup

If you want to run the server directly from a cloned repository for development or testing:

1. Clone the repository:

   # git clone https://github.com/pinkpixel/datetime-mcp.git
   cd datetime-mcp
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. Add the following configuration to your MCP client’s settings file, making sure to replace /path/to/datetime-mcp with the actual absolute path to where you cloned the repository:

   {
     "mcpServers": {
       "datetime-local": {
         "command": "node",
         "args": [
           "/path/to/datetime-mcp/build/index.js"
         ],
         "disabled": false,
         "alwaysAllow": [
           "get_current_datetime"
         ]
       }
     }
   }
   

   (Restart your MCP client application after updating the settings)

Debugging 🐞

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

License 📄

MIT License - Copyright © 2025 Pink Pixel