{"id":31799809,"url":"https://github.com/pierregode/timemcp","last_synced_at":"2025-10-10T22:50:06.963Z","repository":{"id":299418409,"uuid":"1002969617","full_name":"PierreGode/timeMCP","owner":"PierreGode","description":"MCP server for time and date","archived":false,"fork":false,"pushed_at":"2025-06-16T12:57:45.000Z","size":556,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T13:41:38.095Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PierreGode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T12:25:06.000Z","updated_at":"2025-06-16T12:57:49.000Z","dependencies_parsed_at":"2025-06-16T13:45:10.564Z","dependency_job_id":"12488bed-efc0-4340-bf48-4c9e78e05a23","html_url":"https://github.com/PierreGode/timeMCP","commit_stats":null,"previous_names":["pierregode/timemcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PierreGode/timeMCP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreGode%2FtimeMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreGode%2FtimeMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreGode%2FtimeMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreGode%2FtimeMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PierreGode","download_url":"https://codeload.github.com/PierreGode/timeMCP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PierreGode%2FtimeMCP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005458,"owners_count":26083902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T22:50:05.151Z","updated_at":"2025-10-10T22:50:06.957Z","avatar_url":"https://github.com/PierreGode.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Time Server\n\nA Model Context Protocol (MCP) server that provides time and date functionality. This server exposes tools for getting current time, date, and formatting timestamps in various formats and timezones.\n\n![image](https://github.com/user-attachments/assets/a4b9775e-9976-47ad-996d-ba0b4bcf2845)\n\n\n\n## Features\n\n- **get_current_time**: Get current time in ISO, local, UTC, or Unix timestamp format\n- **get_current_date**: Get current date in various formats (ISO, local, short, long, custom)\n- **get_datetime_info**: Get comprehensive date/time information including timezone details\n- **format_timestamp**: Format any Unix timestamp to readable formats\n\n## Installation\n\n1. clone MCP server:\n```bash\ngit clone https://github.com/PierreGode/timeMCP.git\ncd timeMCP\n```\n\n2. Save the server code as `timeserver.js` and the package configuration as `package.json`\n\n3. Install dependencies:\n```bash\nnpm install\n```\n\n4. If in Linux Make the server executable:\n```bash\nchmod +x timeserver.js\n```\n\n## Usage\n\n### Running the Server\n\nThe server runs on stdio transport (standard input/output):\n\n```bash\nnode timeserver.js\n```\n\n\nTo run the server, you need to add it to your MCP configuration. For example, if you are using Claude Desktop, you can do this by modifying the `claude_desktop_config.json` file, for some reason Claude might not recognize the server untill you reinstall the claude desktop app, so you might need to do that after adding the server.\n### Example Configuration for Claude Desktop\n\n```bash\nedit claude_desktop_config.json\n```bash\n{\n  \"mcpServers\": {\n    \"time-server\": {\n      \"command\": \"node\",\n      \"args\": [\"C:\\\\Users\\\\youruser\\\\Documents\\\\timeMCP\\\\timeserver.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n\n### Available Tools\n\n#### 1. get_current_time\nGet the current time in various formats.\n\n**Parameters:**\n- `format` (optional): \"iso\", \"local\", \"utc\", or \"unix\" (default: \"iso\")\n- `timezone` (optional): Timezone string like \"America/New_York\" (default: \"local\")\n\n**Example:**\n```json\n{\n  \"format\": \"local\",\n  \"timezone\": \"Europe/London\"\n}\n```\n\n#### 2. get_current_date\nGet the current date in various formats.\n\n**Parameters:**\n- `format` (optional): \"iso\", \"local\", \"short\", \"long\", or \"custom\" (default: \"iso\")\n- `customFormat` (optional): JSON string of Intl.DateTimeFormat options (when format is \"custom\")\n- `timezone` (optional): Timezone string (default: \"local\")\n\n**Example:**\n```json\n{\n  \"format\": \"long\",\n  \"timezone\": \"Asia/Tokyo\"\n}\n```\n\n#### 3. get_datetime_info\nGet comprehensive date and time information.\n\n**Parameters:**\n- `timezone` (optional): Timezone string (default: \"local\")\n\n**Example:**\n```json\n{\n  \"timezone\": \"America/Los_Angeles\"\n}\n```\n\n#### 4. format_timestamp\nFormat a Unix timestamp.\n\n**Parameters:**\n- `timestamp` (required): Unix timestamp in milliseconds\n- `format` (optional): \"iso\", \"local\", \"utc\", or \"custom\" (default: \"iso\")\n- `timezone` (optional): Timezone string (default: \"local\")\n\n**Example:**\n```json\n{\n  \"timestamp\": 1703097600000,\n  \"format\": \"local\",\n  \"timezone\": \"UTC\"\n}\n```\n\n## Integration with MCP Clients\n\nTo use this server with an MCP client (like Claude Desktop), add it to your MCP configuration:\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"time-server\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/your/mcp-time-server/server.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nFor other MCP clients, refer to their documentation on how to configure MCP servers. The server uses stdio transport and follows the standard MCP protocol.\n\n## Example Responses\n\n### Current Time (ISO format):\n```\nCurrent time (iso): 2024-12-20T14:30:45.123Z\n```\n\n### Current Date (long format):\n```\nCurrent date (long): Friday, December 20, 2024\n```\n\n### DateTime Info:\n```json\n{\n  \"timestamp\": 1703097845123,\n  \"iso\": \"2024-12-20T14:30:45.123Z\",\n  \"local\": \"12/20/2024, 2:30:45 PM\",\n  \"utc\": \"Fri, 20 Dec 2024 14:30:45 GMT\",\n  \"unix\": 1703097845,\n  \"year\": 2024,\n  \"month\": 12,\n  \"day\": 20,\n  \"hour\": 14,\n  \"minute\": 30,\n  \"second\": 45,\n  \"dayOfWeek\": \"Friday\",\n  \"timezone\": \"America/New_York\"\n}\n```\n\n## Development\n\nTo run in development mode with debugging:\n\n```bash\nnpm run dev\n```\n\n## Error Handling\n\nThe server includes comprehensive error handling for:\n- Invalid timezones\n- Invalid timestamps\n- Malformed custom format strings\n- Missing required parameters\n\n## License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierregode%2Ftimemcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpierregode%2Ftimemcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierregode%2Ftimemcp/lists"}