About Time Mcp
Time Mcp is a lightweight MCP server for clients that need the current date or time, with a single tool offering full, date-only, and time-only formats.
Key features
- 01Current date and time
- 02Full, date-only, or time-only output
- 03Lightweight server
Use cases
- 01Checking the current time in an MCP client
- 02Retrieving only the date or time
MCP support
It exposes the `get_time` tool to MCP-compatible clients, with an optional format parameter.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | enum | No | Optional format: "full", "time", or "date" (default: "full")full | time | date |
Details
From the project READMESimple 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
- Clone this repository:
git clone <repository-url>
cd mcp-install
- Install dependencies:
npm install
- 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.