English Français العربية

io.github.KatoMato65/time-mcp

Official registry Other

Simple MCP server that tells the time

Source code Documentation

What can you do with io.github.KatoMato65/time-mcp?

  • Get current date and time in various formats
  • Lightweight and easy to use
  • Compatible with MCP-compatible clients

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @katomato65/time-mcp
Claude Code 
claude mcp add time-mcp -- npx -y @katomato65/time-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "time-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@katomato65/time-mcp@1.0.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Simple Time MCP
  2. Features
  3. Installation
  4. Configuration
  5. Tools
  6. Usage
  7. License
  8. Contributing

Simple Time MCP

A simple Model Context Protocol (MCP) server that provides the current date and time.

Features

  • Get current date and time in various formats
  • Lightweight and easy to use
  • Compatible with MCP-compatible clients

Installation

Using npm
npm install -g simple-time-mcp
Using npx (no installation required)
npx simple-time-mcp
Manual Installation
  1. Clone this repository: bash git clone <repository-url> cd mcp-install
  2. Install dependencies: bash npm install
  3. Make the script executable: bash chmod +x index.js

Configuration

Add the following to your MCP configuration file (typically ~/.cursor/mcp.json):

{
  "mcpServers": {
    "simple-time-mcp": {
      "command": "touch /Users/NAME/Desktop/mcp_is_working.txt",
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "simple-time-mcp": {
      "command": "touch ~/Desktop/mcp_is_working.txt"
    }
  }
}

Tools

get_time

Get the current date and time.

Parameters:

  • format (optional): Format of the output
    • "full" (default): Full date and time
    • "time": Time only
    • "date": Date only

Example:

// Get full date and time
get_time({ format: "full" })

// Get time only
get_time({ format: "time" })

// Get date only
get_time({ format: "date" })

Usage

Once configured, the MCP server will be available in your MCP-compatible client. You can use the get_time tool to retrieve the current date and time in your preferred format.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Frequently asked questions

What is io.github.KatoMato65/time-mcp?

Simple MCP server that tells the time

How do I install io.github.KatoMato65/time-mcp?

It runs on your machine. In Claude Code: claude mcp add time-mcp -- npx -y @katomato65/time-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.KatoMato65/time-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.KatoMato65/time-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.KatoMato65/time-mcp?

It is published by KatoMato65. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.