home / mcp / date mcp server

Date MCP Server

Provides real-time date, time, and timezone information for AI assistants via MCP tools.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "ainarsklavins-date-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ainarsklavins/date-mcp"
      ]
    }
  }
}

You run an MCP server that supplies AI assistants with real-time date, time, and timezone information. It lets you query current date-related data in a structured way, so models can reference accurate temporal context on demand.

How to use

Connect to the date MCP from your MCP client and invoke the available tools to get current date/time, day of week, timezone details, or formatted dates. You can call these tools anytime you need up-to-date temporal information during conversations with AI assistants. All tools are read-only and have no side effects.

How to install

Prerequisites you need before installing:
- Node.js and npm installed on your machine
- An MCP client or environment that supports MCP servers
- Access to run commands in your shell or terminal
# Global installation (optional alternative)
npm install -g @ainarsklavins/date-mcp

Configure an MCP client to use date-mcp

You can wire up the date MCP using several clients. The following configurations use the standard MCP stdio mode with npx. If you install globally, you can switch to the simple binary name date-mcp in place of npx -y @ainarsklavins/date-mcp.

{
  "mcpServers": {
    "date-mcp": {
      "command": "npx",
      "args": ["-y", "@ainarsklavins/date-mcp"]
    }
  }
}

Alternative: use the global command

If you installed the MCP package globally, you can simplify the command.

{
  "mcpServers": {
    "date-mcp": {
      "command": "date-mcp",
      "args": []
    }
  }
}

Available tools

get-current-datetime

Returns the current date and time, with an optional IANA timezone parameter to adjust the output to a specific region.

get-day-of-week

Returns the day name for a given date, defaulting to today if no date is provided.

get-timezone-info

Provides detailed information about the timezone, including offset and abbreviation.

format-date

Formats a given date into different styles and locales.