MCP Simple Timeserver

MCP Simple Timeserver

Provides local and UTC time to AI models via the Model Context Protocol.

25
Stars
15
Forks
25
Watchers
3
Issues
MCP Simple Timeserver provides current local time, timezone, and UTC information to AI models such as Claude by serving as a Model Context Protocol (MCP) tool. It offers two main endpoints: one for retrieving the user's local time and timezone, and another for fetching the current UTC time from an NTP server. The project supports both local and web server deployments and can be integrated into the Claude desktop app to enhance temporal awareness for LLMs.

Key Features

Provides local time and timezone information to AI models
Fetches current UTC time via NTP
MCP-compliant endpoints for easy LLM integration
Supports both local and web server deployments
Simple installation via pip or Smithery CLI
Customizable configuration for Windows and Mac
Improves LLM temporal context awareness
Security assessment badge integration
Works seamlessly with the Claude desktop app
Ready-to-use public server option

Use Cases

Supplying AI models with accurate local time and timezone context
Enabling LLMs like Claude to know current timestamp information
Providing UTC time references for AI workflows
Enhancing conversational context in AI assistants
Automating time-based actions or reminders in AI apps
Integrating temporal awareness into custom AI clients
Running as a public or internal time data server for models
Augmenting architectural prototyping for MCP toolchains
Testing context-aware features in LLM environments
Facilitating real-time, time-sensitive AI interactions

README

MseeP.ai Security Assessment Badge

MCP Simple Timeserver

Trust Score smithery badge

One of the strange design decisions Anthropic made was depriving Claude of timestamps for messages sent by the user or current time in general. Poor Claude can't tell what time it is! mcp-simple-timeserver is a simple MCP server that fixes that.

This server provides two tools:

  • get_local_time provides the current local time and timezone information from the user's machine. This way Claude can know what time it is at the user's location. He can also calculate how much time passed since his last interaction with the user should he want to do so.
  • get_utc provides current UTC time obtained from an NTP time server.

Installation

Installing via Smithery

To install Simple Timeserver for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install mcp-simple-timeserver --client claude

Manual Installation

First install the module using:

bash
pip install mcp-simple-timeserver

Then configure in MCP client - the Claude desktop app.

Under Mac OS this will look like this:

json
"mcpServers": {
  "simple-timeserver": {
    "command": "python",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

Under Windows you have to check the path to your Python executable using where python in the cmd (Windows command line).

Typical configuration would look like this:

json
"mcpServers": {
  "simple-timeserver": {
    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

Web Server Variant

This project also includes a network-hostable version that can be deployed as a standalone web server. For instructions on how to run and deploy it, please see the Web Server Deployment Guide.

Or you can simply use my server by adding it under https://mcp.andybrandt.net/timeserver to Claude. (It does not work with ChatGPT since it currently works only with MCP servers that implement search() and fetch() tools to serve data in response to LLM's querries).

Star History

Star History Chart

Repository Owner

andybrandt
andybrandt

User

Repository Details

Language Python
Default Branch master
Size 2,367 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
77.42%
Batchfile
10.71%
Shell
8.29%
Dockerfile
3.58%

Tags

Topics

claude claude-ai mcp model-context-protocol

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • mcp-time

    mcp-time

    A Model Context Protocol server for time and date operations

    mcp-time is a Model Context Protocol (MCP) server that enables AI assistants and MCP clients to perform standardized time and date-related operations. It provides natural language parsing for relative time expressions, supports flexible formatting, and allows manipulation and comparison of times. The server offers multiple integration methods, including stdio, HTTP stream, Docker, and npx for compatibility with various clients. It is designed for robust time handling and easy integration with AI tools.

    • 8
    • MCP
    • TheoBrigitte/mcp-time
  • mcp-datetime

    mcp-datetime

    Datetime formatting service MCP server for Claude Desktop App

    mcp-datetime provides a datetime formatting service implemented as an MCP server for integration with the Claude Desktop Application. It offers generation of current date and time strings in various formats, including standard, Japanese, ISO, and filename-friendly outputs. The server exposes a 'get_datetime' tool for easy retrieval of formatted dates and times with support for timezone handling and multi-language output. Seamless integration and Python packaging facilitate installation and extensibility.

    • 25
    • MCP
    • ZeparHyfar/mcp-datetime
  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • MyMCP Server (All-in-One Model Context Protocol)

    MyMCP Server (All-in-One Model Context Protocol)

    Powerful and extensible Model Context Protocol server with developer and productivity integrations.

    MyMCP Server is a robust Model Context Protocol (MCP) server implementation that integrates with services like GitLab, Jira, Confluence, YouTube, Google Workspace, and more. It provides AI-powered search, contextual tool execution, and workflow automation for development and productivity tasks. The system supports extensive configuration and enables selective activation of grouped toolsets for various environments. Installation and deployment are streamlined, with both automated and manual setup options available.

    • 93
    • MCP
    • nguyenvanduocit/all-in-one-model-context-protocol
  • Climatiq MCP Server

    Climatiq MCP Server

    MCP server providing AI assistants with real-time carbon emissions calculations via Climatiq API.

    Climatiq MCP Server implements the Model Context Protocol to bridge AI assistants with the Climatiq API for precise carbon emissions calculations. It exposes a set of tools for various emissions scenarios, including electricity use, travel, freight, and more. The server generates resource URIs for detailed emission reports and provides natural language explanations on climate impact. Configuration is streamlined via environment variables, CLI tools, or files, supporting easy integration with platforms like Claude Desktop.

    • 6
    • MCP
    • jagan-shanmugam/climatiq-mcp-server
  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results