{
  "markdown": "# 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities\n\n[![smithery badge](https://smithery.ai/badge/@yokingma/time-mcp)](https://smithery.ai/server/@yokingma/time-mcp) <a href=\"https://github.com/yokingma/time-mcp/stargazers\"><img src=\"https://img.shields.io/github/stars/yokingma/time-mcp\" alt=\"Github Stars\"></a> <a href=\"https://github.com/yokingma/time-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-purple\" alt=\"License\"></a> <a href=\"https://github.com/yokingma/time-mcp/issues/new\"><img src=\"https://img.shields.io/badge/Report a bug-Github-%231F80C0\" alt=\"Report a bug\"></a>\n\nA Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.\n\n<div align=\"center\">\n <img src=\"./assets/cursor.png\"></img>\n</div>\n\n## Tools\n\n- `current_time`: Get current time (UTC and local time)\n- `relative_time`: Get relative time\n- `get_timestamp`: Get timestamp for the time\n- `days_in_month`: Get days in month\n- `convert_time`: Convert time between timezones\n- `get_week_year`: Get week and isoWeek of the year\n\n## Installation\n\n### Installing via Smithery\n\nTo install time-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@yokingma/time-mcp):\n\n```bash\nnpx -y @smithery/cli install @yokingma/time-mcp --client claude\n```\n\n### Manually install (Optional)\n```shell\nnpm install -g time-mcp\n```\n\n### using npx\n```shell\nnpx -y time-mcp\n```\n\n## Running on Claude Code\n\nTo add time-mcp to Claude Code, use the following command:\n\n```bash\nclaude mcp add time-mcp -- npx -y time-mcp\n```\n\nTo verify the installation:\n\n```bash\nclaude mcp list\n```\n\nYou should see time-mcp listed with a ✓ Connected status.\n\n### Usage in Claude Code\n\nOnce installed, you can use time-mcp tools in your conversations with Claude Code. For example:\n\n- \"What time is it now?\"\n- \"Convert 2:00 PM from New York to Tokyo time\"\n- \"How many days are in this month?\"\n- \"What week of the year is it?\"\n\nThe time-mcp server will automatically provide accurate time information to Claude.\n\n## Running on Cursor\n\nYour `mcp.json` file will look like this:\n\n```json\n{\n  \"mcpServers\": {\n    \"time-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"time-mcp\"]\n    }\n  }\n}\n```\n\n## Running on Windsurf\n\nAdd this to your `./codeium/windsurf/model_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"time-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"time-mcp\"]\n    }\n  }\n}\n```\n\n## License\n\nMIT License - see [LICENSE](./LICENSE) file for details.\n",
  "bytes": 2510,
  "sha": "7484237e05a91d27151fba13c837e839c61955d263e095418bbdfd7d5c7cca77",
  "repo_slug": "yokingma/time-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_yokingma_time_mcp_61c16010/readme"
}