Built as a Node.js application using the MCP SDK to provide time-related functionality
Uses npm for package management and includes build scripts for TypeScript compilation
Implemented in TypeScript with proper type definitions and compilation to JavaScript
Time MCP Server
A Model Context Protocol (MCP) server that provides time and date information for AI assistants like Claude in VSCode.
Features
- Current Time: Get the current time in various formats
- Timezone Support: Query time in different timezones
- Detailed Info: Get comprehensive time information including day of week, timestamp, etc.
- Multiple Formats: Support for 12-hour, 24-hour, and ISO formats
Available Tools
get_current_time
Get the current date and time with formatting options.
Parameters:
timezone
(optional): Timezone identifier (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")format
(optional): Time format - "12hour" (default), "24hour", or "iso"
Examples:
- "What time is it?"
- "Get current time in Tokyo"
- "Show me the time in 24-hour format"
get_time_info
Get detailed time information including timezone data, day of week, and timestamps.
Parameters:
timezone
(optional): Timezone identifier
Examples:
- "Give me detailed time information"
- "Show time info for London timezone"
Installation
- Clone or create the project:
- Install dependencies:
- Build the project:
Configuration
For Claude in VSCode
Create an mcp.json
file in your project or workspace:
Important: Replace /absolute/path/to/time-mcp-server/
with the actual absolute path to your project directory.
Example Configuration
Usage
Once configured with Claude in VSCode, you can ask natural language questions:
- "What time is it?" → Returns current time
- "What time is it in New York?" → Returns time in EST/EDT
- "Show me the time in 24-hour format" → Returns time in 24-hour format
- "Get detailed time information" → Returns comprehensive time data
- "What day is today?" → Uses detailed info to show current day
Development
Project Structure
Scripts
npm run build
- Build TypeScript to JavaScriptnpm run dev
- Build and run the server (for MCP clients)npm start
- Run the built server (for MCP clients)npm test
- Quick test to verify server is working
Testing
Quick Test:
Manual Testing:
Note: npm start
and npm run dev
will appear to "hang" - this is normal! The server is waiting for MCP protocol messages on stdin. Use the test commands above or configure with Claude to interact with it.
Supported Timezones
The server supports any valid IANA timezone identifier, including:
America/New_York
Europe/London
Asia/Tokyo
Australia/Sydney
UTC
Dependencies
@modelcontextprotocol/sdk
- Official MCP SDKtypescript
- TypeScript compiler@types/node
- Node.js type definitions
License
MIT
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Build and test:
npm run build
- Submit a pull request
Troubleshooting
Common Issues
"No inputs were found" error:
- Ensure the
src/index.ts
file exists - Run
npm run build
after creating the file
Server appears to hang:
- This is normal behavior! The server waits for MCP protocol messages on stdin
- Use
npm test
for quick verification, or configure with Claude for actual usage - The server only responds when it receives proper JSON-RPC messages
TypeScript errors:
- Make sure all dependencies are installed:
npm install
- Check TypeScript version compatibility
Debug Mode
Add console logging by setting environment variables:
Version History
- 0.1.0 - Initial release with basic time functionality
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides current time and date information with timezone support and multiple formatting options. Enables AI assistants to answer time-related queries in different timezones with detailed temporal information.
Related MCP Servers
- AsecurityAlicenseAqualityAccess the time in any timezone and get the current local timeLast updated -139MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides the current time in any timezone with customizable formatting, allowing AI assistants to access accurate time information.Last updated -MIT License
- -securityFlicense-qualityProvides real-time weather information and forecasts, connecting AI assistants with live weather data for current conditions and multi-day forecasts for any location worldwide.Last updated -
- AsecurityAlicenseAqualityProvides comprehensive time manipulation capabilities including timezone conversions, date arithmetic, business day calculations, duration calculations, and recurring event handling. Enables natural language time queries with high performance and intelligent caching.Last updated -111MIT License