iamsaad640/date-mcp-server

Date MCP Server

A simple MCP (Model Context Protocol) server that provides current date and time information for Claude Code integration.

Features

• Get today's date
• Get current date and time
• Lightweight Node.js implementation

Prerequisites

• Node.js: Ensure Node.js is installed on your system

  • Download from nodejs.org
  • Verify installation: node --version

• Claude Code: Install Claude Code following the official documentation

Project Structure

date-mcp/
├── README.md
├── package.json
├── package-lock.json
├── date-server.js
└── node_modules/

Installation

1. Clone or download this repository
2. Install dependencies:

   npm install
   

Configuration

Option 1: Using Claude MCP Command (Recommended)

Ubuntu/Linux

# Navigate to your project directory
cd /path/to/your-project

# Add the MCP server using relative path
claude mcp add date-server -- node date-mcp/date-server.js

Windows

# Navigate to your project directory
cd P:\path\to\your-project

# Add the MCP server using relative path
claude mcp add date-server -- node date-mcp/date-server.js

Option 2: Manual Configuration

Create a .claude folder in your project directory and add mcp-config.json:

{
  "mcpServers": {
    "date-server": {
      "command": "node",
      "args": ["date-mcp/date-server.js"]
    }
  }
}

Verification

After configuration, verify the MCP server is working:

claude mcp list

You should see date-server listed with the correct path.

Usage

Once configured, the date server provides these functions in Claude Code:

• get_today_date() - Returns today's date in a readable format
• get_current_datetime() - Returns current date and time

Platform-Specific Notes

Ubuntu/Linux

• Use forward slashes in paths: date-mcp/date-server.js
• Ensure execute permissions: chmod +x date-server.js

Windows

• Use forward slashes or escaped backslashes: date-mcp\\date-server.js
• Git Bash or WSL recommended for consistent command-line experience

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test on both Windows and Ubuntu
5. Submit a pull request

License

This project is open source and available under the .