# Time MCP

> Time MCP is an open-source MCP server for time utilities. MCP server that returns the current date and time as full, time-only or date-only output. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/katomato65/time-mcp
- **MCP Registry name:** io.github.KatoMato65/time-mcp
- **Categories:** [time utilities](https://ai-powered.com/categories/time-utilities)
- **Listing updated:** 2026-11-18

## About

Time MCP is a small Model Context Protocol server that exposes a single get_time tool. It runs over stdio, so an MCP-compatible client can launch it locally and call the tool when it needs the current clock reading. The package is published on npm and can be run with npx or installed globally.

The tool takes an optional format argument: full (the default) returns date and time together, while time and date return only that part. The README describes it as lightweight, with no other tools or resources listed.

The README's sample client configuration uses a shell touch command as the server command instead of the package launch command, so check the setup before copying it. The npm package name in the install instructions also differs from the registry identifier, so confirm which package to install.

## Features

- **Single get_time tool:** Provides one tool that returns the current date and time.
- **Selectable output format:** The format option returns full date and time, time only, or date only.
- **Stdio transport:** Runs as a local process that MCP clients start over standard input and output.
- **npm and npx install:** Can be installed globally with npm or run on demand with npx.

## Good for

- Giving an AI assistant access to the current date and time during a conversation
- Adding a timestamp lookup to an MCP client workflow without calling an external service
- Testing MCP client setup with a minimal, dependency-light server

## Install

### Claude Code (Terminal)

```sh
claude mcp add time-mcp -- npx -y @katomato65/time-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "time-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@katomato65/time-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_time`: Gets the current date and time, optionally as full, time-only or date-only output.

## FAQ

### What tool does the server expose?

A single tool named get_time, which takes an optional format parameter set to full, time or date.

### What license is it under?

The README states the MIT license.

### How can it be installed?

The README gives npm install -g simple-time-mcp for a global install and npx simple-time-mcp to run without installing.

### Is Time MCP free?

Yes. Time MCP is open source, so you can use and self-host it for free.

### How do I add Time MCP to Claude Code?

Run this command in your terminal: claude mcp add time-mcp -- npx -y @katomato65/time-mcp

### What are the best alternatives to Time MCP?

The closest alternatives to Time MCP are MCP Time, Timeapi MCP, Timestamp, Datecalc and Etc/UTC clock.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP Time](https://ai-powered.com/mcp/mcp-time-2): MCP Time is an open-source MCP server for time utilities.
- [Timeapi MCP](https://ai-powered.com/mcp/timeapi-mcp): Timeapi MCP is an open-source MCP server for time utilities.
- [Timestamp](https://ai-powered.com/mcp/timestamp): Timestamp is a freemium MCP server for time utilities.
- [Datecalc](https://ai-powered.com/mcp/datecalc): Datecalc is a freemium MCP server for time utilities.
- [Etc/UTC clock](https://ai-powered.com/mcp/etc-utc-clock): Etc/UTC clock is an MCP server for time utilities.
- [Europe/Athens clock](https://ai-powered.com/mcp/europe-athens-clock): Europe/Athens clock is an MCP server for time utilities.
- [Asia/Macau clock](https://ai-powered.com/mcp/asia-macau-clock): Asia/Macau clock is an MCP server for time utilities.
- [RFC 3339 UTC stamp](https://ai-powered.com/mcp/rfc-3339-utc-stamp): RFC 3339 UTC stamp is an MCP server for time utilities.

---
Source: https://ai-powered.com/mcp/time-mcp
