# Time Mcp

> ⏰ Time MCP Server: Giving LLMs Time Awareness Capabilities

- **Type:** MCP server
- **Install:** `agentstack add mcp-yokingma-time-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yokingma](https://agentstack.voostack.com/s/yokingma)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yokingma](https://github.com/yokingma)
- **Source:** https://github.com/yokingma/time-mcp

## Install

```sh
agentstack add mcp-yokingma-time-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

[](https://smithery.ai/server/@yokingma/time-mcp)   

A Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.

 

## Tools

- `current_time`: Get current time (UTC and local time)
- `relative_time`: Get relative time
- `get_timestamp`: Get timestamp for the time
- `days_in_month`: Get days in month
- `convert_time`: Convert time between timezones
- `get_week_year`: Get week and isoWeek of the year

## Installation

### Installing via Smithery

To install time-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@yokingma/time-mcp):

```bash
npx -y @smithery/cli install @yokingma/time-mcp --client claude
```

### Manually install (Optional)
```shell
npm install -g time-mcp
```

### using npx
```shell
npx -y time-mcp
```

## Running on Claude Code

To add time-mcp to Claude Code, use the following command:

```bash
claude mcp add time-mcp -- npx -y time-mcp
```

To verify the installation:

```bash
claude mcp list
```

You should see time-mcp listed with a ✓ Connected status.

### Usage in Claude Code

Once installed, you can use time-mcp tools in your conversations with Claude Code. For example:

- "What time is it now?"
- "Convert 2:00 PM from New York to Tokyo time"
- "How many days are in this month?"
- "What week of the year is it?"

The time-mcp server will automatically provide accurate time information to Claude.

## Running on Cursor

Your `mcp.json` file will look like this:

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

## Running on Windsurf

Add this to your `./codeium/windsurf/model_config.json` file:

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

## License

MIT License - see [LICENSE](./LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yokingma](https://github.com/yokingma)
- **Source:** [yokingma/time-mcp](https://github.com/yokingma/time-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yokingma-time-mcp
- Seller: https://agentstack.voostack.com/s/yokingma
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.