Provides a time utility that leverages Python's datetime handling capabilities to retrieve and format current time in various timezones through the pytz library.
MCPCurrentTime
A python Model Context Protocol (MCP) server that provides a simple and reliable way to get the current time in any timezone with customizable formatting.
Overview
MCPCurrentTime is an MCP server that wraps a time utility tool, allowing AI assistants and other MCP clients to retrieve the current time in various timezones and formats. This is particularly useful for applications that need timezone-aware time information or want to display time in user-friendly formats.
The server is based on the python mcp package.
Features
- Timezone Support: Get current time in any timezone supported by the
pytz
library - Flexible Formatting: Customize time output using Python's
strftime
directives - Error Handling: Robust error handling for invalid timezones and format strings
- Simple Integration: Easy to integrate with any MCP-compatible application
Installation
Prerequisites
- Python 3.7+
- Required packages:
mcp
pytz
- install with
pip install MCPCurrentTime
Usage
Running the Server
You can run the MCP server in several ways:
Command Line, with stdio transport
As a Module
Custom Transport
Tool Usage
The server provides a single tool called get_time
with the following parameters:
Parameters
- time_format (optional, default:
"%Y%m%d%H%M%S"
): The format string for time output - timezone (optional, default:
"UTC"
): The timezone to get the current time for
Time Format Examples
The time_format
parameter uses Python's strftime directives:
"%Y-%m-%d %H:%M:%S"
→"2025-06-30 14:30:45"
"%Y%m%d%H%M%S"
→"20250630143045"
(default)"%B %d, %Y at %I:%M %p"
→"June 30, 2025 at 02:30 PM"
"%A, %B %d, %Y"
→"Monday, June 30, 2025"
Timezone Examples
The timezone
parameter accepts any timezone from the pytz library:
"UTC"
(default)"America/New_York"
"Europe/London"
"Asia/Tokyo"
"Australia/Sydney"
"America/Los_Angeles"
Example Calls
AI Assistant Integration
A tool for AI assistants that need to:
- Schedule appointments and events
- Provide time-aware responses
- Generate timestamps for logs or documents
- Real-time clock functionality
- Time-based file naming
- Log generation with timezone awareness
- Batch processing with time tracking
- ...
License
This project is open source. Please refer to the LICENSE file for details.
This server cannot be installed
A Model Context Protocol server that provides the current time in any timezone with customizable formatting, allowing AI assistants to access accurate time information.
Related MCP Servers
- AsecurityAlicenseAqualityA TypeScript server implementing the Model Context Protocol (MCP) that provides datetime and timezone information to AI agents and chat interfaces, allowing them to access current time in various timezones.Last updated -42TypeScriptMozilla Public License 2.0
- AsecurityFlicenseAqualityA Model Context Protocol server that provides time and timezone conversion capabilities, enabling LLMs to get current time information and perform timezone conversions using IANA timezone names.Last updated -21Python
- AsecurityAlicenseAqualityA Model Context Protocol server for time manipulation tasks, enabling AI models to get the current date/time and calculate duration between timestamps.Last updated -2TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that integrates with TickTick task management service, allowing AI assistants to list, create, update, and complete tasks with proper timezone handling.Last updated -1JavaScriptMIT License