MCP.so
Sign In

Time MCP Server

@petrarca

Repository

About Time MCP Server

Time MCP Server providing time-related tools with timezone support

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

3

`date_format` (optional): Format string for the datetime (e.g., '%Y-%m-%d %H:%M:%S')

A dictionary with the current time in ISO format and the requested format

A dictionary with year, month, day, hour, minute, second, microsecond, and weekday

Overview

What is Time MCP Server?

Time MCP Server is a Model Context Protocol (MCP) server that provides time-related tools for Large Language Models. Built with FastMCP 2.0, it lets LLMs retrieve the current date, time, and time components using standard MCP tool calls.

How to use Time MCP Server?

Clone the repository, run task setup to create a virtual environment, then task install to install the package. Start the server with task run (uses stdio transport by default). You can also run with HTTP transport via task run -- --transport streamable-http --port 9000. Connect an MCP client and call get_current_time or get_time_components.

Key features of Time MCP Server

  • Provides get_current_time tool with optional custom date formatting
  • Provides get_time_components tool returning year, month, day, etc.
  • Supports stdio transport by default; HTTP transport also available
  • Works out of the box with Claude Desktop via stdio
  • Written in Python 3.12+ with FastMCP 2.0
  • Includes tests using FastMCP's in-memory client

Use cases of Time MCP Server

  • Let an LLM answer "What's the current time?" with real system time
  • Provide formatted date strings (e.g., "YYYY-MM-DD HH:MM:SS") to an LLM
  • Allow an LLM to determine today's day of the week
  • Enable an LLM to break current time into individual components (hour, minute, etc.)

FAQ from Time MCP Server

What tools does Time MCP Server provide?

It provides two tools: get_current_time (returns the current time in ISO and a custom format) and get_time_components (returns year, month, day, hour, minute, second, microsecond, and weekday).

How do I run Time MCP Server?

Use the task runner: task run for the default stdio transport. To use HTTP, run task run -- --transport streamable-http --port 9000.

Can I use HTTP instead of stdio?

Yes. Pass the --transport streamable-http and --port 9000 options when starting the server, either via task run -- or directly with python -m time_mcp_server.main.

What prerequisites are needed?

Python 3.12 or higher, uv for package management, and Task as the task runner.

How do I connect Time MCP Server to Claude Desktop?

Add a JSON entry to Claude Desktop's MCP configuration file (under Settings > Developer > Edit Config) with the command path to uv and the appropriate arguments pointing to your project directory.

Frequently asked questions

What tools does Time MCP Server provide?

It provides two tools: `get_current_time` (returns the current time in ISO and a custom format) and `get_time_components` (returns year, month, day, hour, minute, second, microsecond, and weekday).

How do I run Time MCP Server?

Use the task runner: `task run` for the default stdio transport. To use HTTP, run `task run -- --transport streamable-http --port 9000`.

Can I use HTTP instead of stdio?

Yes. Pass the `--transport streamable-http` and `--port 9000` options when starting the server, either via `task run --` or directly with `python -m time_mcp_server.main`.

What prerequisites are needed?

Python 3.12 or higher, [uv](https://github.com/astral-sh/uv) for package management, and [Task](https://taskfile.dev/) as the task runner.

How do I connect Time MCP Server to Claude Desktop?

Add a JSON entry to Claude Desktop's MCP configuration file (under Settings > Developer > Edit Config) with the command path to `uv` and the appropriate arguments pointing to your project directory.

Comments

Basic information

Category

Productivity

Transports

stdio

Author

petrarca

More Productivity MCP servers

ListingGood MCP

DedeGroup

ListingGood AI Recommendation Engine — a hosted MCP server + Claude/Cursor skills that make Amazon's AI recommend your products. Free no-login scan: https://listinggood.com/scan Get API key: https://listinggood.com/deve

1

Turnale

Turnale.app

Tournament software for tennis, padel, pickleball and more: fair draws, live standings, scores and dropout handling. Run recreational racket-sport tournaments from chat: schedules for americano, mexicano, round robin, g

Syncro

Syncro Technologies, Inc

Syncro is a Remote Monitoring and Management (RMM) and Professional Services Automation (PSA) platform. Connect Claude to your Syncro instance for live access to tickets, alerts, customers, contacts, assets, products, ap

Contio MeetingOS

Andrew Ely

Contio MeetingOS is an AI-powered workspace for meeting-driven teams. — from planning to follow-through. It gives you a structured workspace to build agendas, collaborate with participants in real time, capture transcri

AdminLanding

Julien Maurice

AdminLanding — French rental, frontalier & home-employment compliance tools (FR/EN). Sourced, dated answers from deterministic rule engines and official datasets — no AI, no account needed for the 10 free tools: zone ten