{"_id":"@ainarsklavins/date-mcp","_rev":"2-8497f2912076adc7d2cf68ad5c720427","name":"@ainarsklavins/date-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@ainarsklavins/date-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","date","time","timezone","claude","ai-tools"],"author":{"name":"Ainars Klavins"},"license":"MIT","_id":"@ainarsklavins/date-mcp@1.0.0","maintainers":[{"name":"ainarsklavins","email":"klavins.ainars@gmail.com"}],"homepage":"https://github.com/ainarsklavins/date-mcp#readme","bugs":{"url":"https://github.com/ainarsklavins/date-mcp/issues"},"bin":{"date-mcp":"dist/index.js"},"dist":{"shasum":"df33e74e7e244cf548314544687e434ad3533d1a","tarball":"https://registry.npmjs.org/@ainarsklavins/date-mcp/-/date-mcp-1.0.0.tgz","fileCount":6,"integrity":"sha512-Z7wpoT24tNfASPD9aRTXqtOE6/4J4sGzieMSuoUI8xLVFiReLTMZEtMogqiM8NEQbZAiPk/nyQews3hfblBX9g==","signatures":[{"sig":"MEQCIHoOPa3Y3UweRlzdHqODAUjZGsBOCYp8taoOa8hUrcj2AiAFAtmkYRZ/NaeVsi/6Nuz1bxbcp21TMPHk4CbdGgwFug==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ainarsklavins%2fdate-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":21459},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f44fba24af8c63545efaf30997285f2d903604ce","scripts":{"dev":"tsup --watch","build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"ainarsklavins","email":"klavins.ainars@gmail.com"},"repository":{"url":"git+https://github.com/ainarsklavins/date-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing date, time, and timezone tools for Claude and other MCP clients","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.22.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.9.3","@types/node":"^24.10.1"},"_npmOperationalInternal":{"tmp":"tmp/date-mcp_1.0.0_1764056631521_0.5012399147630375","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ainarsklavins/date-mcp","version":"1.0.1","description":"MCP server providing date, time, and timezone tools for Claude and other MCP clients","type":"module","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"date-mcp":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsup --watch","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","date","time","timezone","claude","ai-tools"],"author":{"name":"Ainars Klavins"},"license":"MIT","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/ainarsklavins/date-mcp.git"},"bugs":{"url":"https://github.com/ainarsklavins/date-mcp/issues"},"homepage":"https://github.com/ainarsklavins/date-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.22.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.10.1","tsup":"^8.5.1","typescript":"^5.9.3"},"_id":"@ainarsklavins/date-mcp@1.0.1","gitHead":"80a81d239c96a781ce4792d95e62ac9373a97e05","_nodeVersion":"20.19.5","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Mfgg61PGe5gUwu4AEZ6CSzYSuVTg2Oi0fq5UqA1KqJ/YNIRBvfiVHl7JSPj4Q3o9GX3iFqgfKgq7hCMYsmn2lg==","shasum":"fccb507ce8635a2bca83796e038f9b9004a042dd","tarball":"https://registry.npmjs.org/@ainarsklavins/date-mcp/-/date-mcp-1.0.1.tgz","fileCount":6,"unpackedSize":22791,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ainarsklavins%2fdate-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCvlBVpwuGJ7jhU3Ttm4k5gskGJMoYtqB0Pl/b45Me7aAIgcG8NDExqZmNuJwXwdB9eKErOsoZwqIP5k5yDEyRLLPs="}]},"_npmUser":{"name":"ainarsklavins","email":"klavins.ainars@gmail.com"},"directories":{},"maintainers":[{"name":"ainarsklavins","email":"klavins.ainars@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/date-mcp_1.0.1_1764057875425_0.6910120261964374"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-25T07:43:51.446Z","modified":"2025-11-25T08:04:36.071Z","1.0.0":"2025-11-25T07:43:51.735Z","1.0.1":"2025-11-25T08:04:35.623Z"},"bugs":{"url":"https://github.com/ainarsklavins/date-mcp/issues"},"author":{"name":"Ainars Klavins"},"license":"MIT","homepage":"https://github.com/ainarsklavins/date-mcp#readme","keywords":["mcp","model-context-protocol","date","time","timezone","claude","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/ainarsklavins/date-mcp.git"},"description":"MCP server providing date, time, and timezone tools for Claude and other MCP clients","maintainers":[{"name":"ainarsklavins","email":"klavins.ainars@gmail.com"}],"readme":"# @ainarsklavins/date-mcp\n\n[![npm version](https://badge.fury.io/js/%40ainarsklavins%2Fdate-mcp.svg)](https://www.npmjs.com/package/@ainarsklavins/date-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nAn MCP server that provides real-time date, time, and timezone information to AI assistants.\n\n## Why Use This?\n\nAI models don't inherently know the current date or time. This MCP server solves that by providing tools that return accurate, real-time temporal information.\n\n## Installation\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n| OS | Path |\n|----|------|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"date-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainarsklavins/date-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add --scope user date-mcp -- npx -y @ainarsklavins/date-mcp\n```\n\n<details>\n<summary>Manual configuration</summary>\n\nAdd to `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"date-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainarsklavins/date-mcp\"]\n    }\n  }\n}\n```\n</details>\n\n### VS Code\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=date-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40ainarsklavins%2Fdate-mcp%22%5D%7D)\n[![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=date-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40ainarsklavins%2Fdate-mcp%22%5D%7D&quality=insiders)\n\nOr manually add to your VS Code MCP settings (`Ctrl+Shift+P` → \"MCP: Open User Configuration\"):\n\n```json\n{\n  \"servers\": {\n    \"date-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainarsklavins/date-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to Cursor's MCP settings (Settings → MCP Servers):\n\n```json\n{\n  \"mcpServers\": {\n    \"date-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainarsklavins/date-mcp\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"date-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainarsklavins/date-mcp\"]\n    }\n  }\n}\n```\n\n<details>\n<summary>Alternative: Global Installation</summary>\n\n```bash\nnpm install -g @ainarsklavins/date-mcp\n```\n\nThen use `\"command\": \"date-mcp\"` instead of npx in any configuration above.\n</details>\n\n## Available Tools\n\n| Tool | Description | Read-only |\n|------|-------------|-----------|\n| `get-current-datetime` | Get current date/time with timezone | Yes |\n| `get-day-of-week` | Get day name for any date | Yes |\n| `get-timezone-info` | Get timezone offset and details | Yes |\n| `format-date` | Format dates in various styles | Yes |\n\nAll tools are read-only and have no side effects.\n\n### get-current-datetime\n\nReturns the current date and time.\n\n**Parameters:**\n| Name | Type | Required | Description |\n|------|------|----------|-------------|\n| `timezone` | string | No | IANA timezone (e.g., `America/New_York`) |\n\n**Example:**\n```json\n{\n  \"iso\": \"2024-12-15T14:30:00.000Z\",\n  \"formatted\": \"12/15/2024, 9:30:00 AM\",\n  \"timezone\": \"America/New_York\",\n  \"timestamp\": 1734272200000\n}\n```\n\n### get-day-of-week\n\nReturns the day of the week for a given date.\n\n**Parameters:**\n| Name | Type | Required | Description |\n|------|------|----------|-------------|\n| `date` | string | No | Date in YYYY-MM-DD format (defaults to today) |\n| `locale` | string | No | Locale code (e.g., `en-US`, `de-DE`) |\n\n**Example:**\n```json\n{\n  \"dayName\": \"Sunday\",\n  \"dayNumber\": 0,\n  \"date\": \"2024-12-15\"\n}\n```\n\n### get-timezone-info\n\nReturns detailed timezone information.\n\n**Parameters:**\n| Name | Type | Required | Description |\n|------|------|----------|-------------|\n| `timezone` | string | No | IANA timezone name |\n\n**Example:**\n```json\n{\n  \"timezone\": \"America/New_York\",\n  \"offset\": \"GMT-05:00\",\n  \"abbreviation\": \"EST\",\n  \"currentTime\": \"12/15/2024, 9:30:00 AM\"\n}\n```\n\n### format-date\n\nFormats a date in various styles.\n\n**Parameters:**\n| Name | Type | Required | Description |\n|------|------|----------|-------------|\n| `date` | string | No | Date in ISO format (defaults to today) |\n| `style` | string | No | `short`, `medium`, `long`, or `full` |\n| `locale` | string | No | Locale code (e.g., `en-US`, `fr-FR`) |\n\n**Example:**\n```json\n{\n  \"formatted\": \"December 15, 2024\",\n  \"style\": \"long\",\n  \"locale\": \"en-US\",\n  \"iso\": \"2024-12-15T00:00:00.000Z\"\n}\n```\n\n## Supported Timezones\n\nUses IANA timezone database. Common examples:\n- `America/New_York`, `America/Los_Angeles`, `America/Chicago`\n- `Europe/London`, `Europe/Paris`, `Europe/Berlin`\n- `Asia/Tokyo`, `Asia/Shanghai`, `Asia/Singapore`\n- `Australia/Sydney`\n- `UTC`\n\nFull list: [IANA Time Zone Database](https://www.iana.org/time-zones)\n\n## Debugging\n\nYou can use the MCP Inspector to debug the server:\n\n```bash\nnpx @modelcontextprotocol/inspector npx -y @ainarsklavins/date-mcp\n```\n\n## Development\n\n```bash\ngit clone https://github.com/ainarsklavins/date-mcp.git\ncd date-mcp\nnpm install\nnpm run build\n```\n\n### Testing Locally\n\nAdd to Claude Code with direct path:\n\n```json\n{\n  \"mcpServers\": {\n    \"date-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/date-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## License\n\nMIT - see [LICENSE](LICENSE)\n","readmeFilename":"README.md"}