Back to Directory/Developer Tools

io.github.KatoMato65/time-mcp

Simple MCP server that tells the time

Developer ToolsJavaScriptv1.0.3

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:
git clone <repository-url>
cd mcp-install
  1. Install dependencies:
npm install
  1. Make the script executable:
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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @katomato65/time-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-katomato65-time-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@katomato65/time-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@katomato65/time-mcpnpm

Compatible MCP Clients

io.github.KatoMato65/time-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More