Skills · Data & AI · Agent

Time MCP Server

Unverified29/40

Originally by modelcontextprotocol · MIT

Claude Code·UnknownFrontmatter could not be read
Cursor·UnknownWe have not crawled the repo tree, so we will not guess
Codex·UnknownWe have not crawled the repo tree, so we will not guess
Gemini CLI·UnknownThe spec defines no detection rule for Gemini
Copilot·UnknownWe have not crawled the repo tree, so we will not guess
npx agentalley add time

This command does not work yet — the CLI is still being built. Until then, use Raw in the reader below to take the file.

Who is stuck, and on what

The whole source

No sign-in, no blur, nothing truncated
time/SKILL.md298 lines7.4 KBRawView on GitHub
Frontmatter: no frontmatter — costs points on criterion B3.
1# Time MCP ServerA5No allowed-tools declared — no way to tell what this skill may touchB3Frontmatter: no frontmatter
2 
3<!-- mcp-name: io.github.modelcontextprotocol/server-time -->
4 
5A Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.
6 
7Source: https://github.com/modelcontextprotocol/servers/tree/main/src/time
8 
9Requires MCP Python SDK 1.x (`mcp>=1.29.0,<2`). SDK 2.0 renamed APIs this server uses. The port to v2 is in progress.
10 
11### Available Tools
12 
13- `get_current_time` - Get current time in a specific timezone or system timezone.
14 - Required arguments:
15 - `timezone` (string): IANA timezone name (e.g., 'America/New_York', 'Europe/London')
16 
17- `convert_time` - Convert time between timezones.
18 - Required arguments:
19 - `source_timezone` (string): Source IANA timezone name
20 - `time` (string): Time in 24-hour format (HH:MM)
21 - `target_timezone` (string): Target IANA timezone name
22 
23## Installation
24 
25### Using uv (recommended)
26 
27When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
28use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-time*.
29 
30```bash
31uvx mcp-server-time
32```
33 
34### Using PIP
35 
36Alternatively you can install `mcp-server-time` via pip:
37 
38```bash
39pip install mcp-server-time
40```
41 
42After installation, you can run it as a script using:
43 
44```bash
45python -m mcp_server_time
46```
47 
48## Configuration
49 
50### Configure for Claude.app
51 
52Add to your Claude settings:
53 
54<details>
55<summary>Using uvx</summary>
56 
57```json
58{
59 "mcpServers": {
60 "time": {
61 "command": "uvx",
62 "args": ["mcp-server-time"]
63 }
64 }
65}
66```
67</details>
68 
69<details>
70<summary>Using docker</summary>
71 
72```json
73{
74 "mcpServers": {
75 "time": {
76 "command": "docker",
77 "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
78 }
79 }
80}
81```
82</details>
83 
84<details>
85<summary>Using pip installation</summary>
86 
87```json
88{
89 "mcpServers": {
90 "time": {
91 "command": "python",
92 "args": ["-m", "mcp_server_time"]
93 }
94 }
95}
96```
97</details>
98 
99### Configure for Zed
100 
101Add to your Zed settings.json:
102 
103<details>
104<summary>Using uvx</summary>
105 
106```json
107"context_servers": [
108 "mcp-server-time": {
109 "command": "uvx",
110 "args": ["mcp-server-time"]
111 }
112],
113```
114</details>
115 
116<details>
117<summary>Using pip installation</summary>
118 
119```json
120"context_servers": {
121 "mcp-server-time": {
122 "command": "python",
123 "args": ["-m", "mcp_server_time"]
124 }
125},
126```
127</details>
128 
129### Configure for VS Code
130 
131For quick installation, use one of the one-click install buttons below...
132 
133[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D) [![Install with UV in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-UV-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D&quality=insiders)B1Line is 590 characters — unreadable by eye
134 
135[![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Ftime%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Ftime%22%5D%7D&quality=insiders)B1Line is 674 characters — unreadable by eye
136 
137For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.
138 
139Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.
140 
141> Note that the `mcp` key is needed when using the `mcp.json` file.
142 
143<details>
144<summary>Using uvx</summary>
145 
146```json
147{
148 "mcp": {
149 "servers": {
150 "time": {
151 "command": "uvx",
152 "args": ["mcp-server-time"]
153 }
154 }
155 }
156}
157```
158</details>
159 
160<details>
161<summary>Using Docker</summary>
162 
163```json
164{
165 "mcp": {
166 "servers": {
167 "time": {
168 "command": "docker",
169 "args": ["run", "-i", "--rm", "mcp/time"]
170 }
171 }
172 }
173}
174```
175</details>
176 
177### Configure for Zencoder
178 
1791. Go to the Zencoder menu (...)
1802. From the dropdown menu, select `Agent Tools`
1813. Click on the `Add Custom MCP`
1824. Add the name and server configuration from below, and make sure to hit the `Install` button
183 
184<details>
185<summary>Using uvx</summary>
186 
187```json
188{
189 "command": "uvx",
190 "args": ["mcp-server-time"]
191 }
192```
193</details>
194 
195### Customization - System Timezone
196 
197By default, the server automatically detects your system's timezone. You can override this by adding the argument `--local-timezone` to the `args` list in the configuration.
198 
199Example:
200```json
201{
202 "command": "python",
203 "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
204}
205```
206 
207## Example Interactions
208 
2091. Get current time:
210```json
211{
212 "name": "get_current_time",
213 "arguments": {
214 "timezone": "Europe/Warsaw"
215 }
216}
217```
218Response:
219```json
220{
221 "timezone": "Europe/Warsaw",
222 "datetime": "2024-01-01T13:00:00+01:00",
223 "is_dst": false
224}
225```
226 
2272. Convert time between timezones:
228```json
229{
230 "name": "convert_time",
231 "arguments": {
232 "source_timezone": "America/New_York",
233 "time": "16:30",
234 "target_timezone": "Asia/Tokyo"
235 }
236}
237```
238Response:
239```json
240{
241 "source": {
242 "timezone": "America/New_York",
243 "datetime": "2024-01-01T12:30:00-05:00",
244 "is_dst": false
245 },
246 "target": {
247 "timezone": "Asia/Tokyo",
248 "datetime": "2024-01-01T12:30:00+09:00",
249 "is_dst": false
250 },
251 "time_difference": "+13.0h",
252}
253```
254 
255## Debugging
256 
257You can use the MCP inspector to debug the server. For uvx installations:
258 
259```bash
260npx @modelcontextprotocol/inspector uvx mcp-server-time
261```
262 
263Or if you've installed the package in a specific directory or are developing on it:
264 
265```bash
266cd path/to/servers/src/time
267npx @modelcontextprotocol/inspector uv run mcp-server-time
268```
269 
270## Examples of Questions for Claude
271 
2721. "What time is it now?" (will use system timezone)
2732. "What time is it in Tokyo?"
2743. "When it's 4 PM in New York, what time is it in London?"
2754. "Convert 9:30 AM Tokyo time to New York time"
276 
277## Build
278 
279Docker build:
280 
281```bash
282cd src/time
283docker build -t mcp/time .
284```
285 
286## Contributing
287 
288We encourage contributions to help expand and improve mcp-server-time. Whether you want to add new time-related tools, enhance existing functionality, or improve documentation, your input is valuable.
289 
290For examples of other MCP servers and implementation patterns, see:
291https://github.com/modelcontextprotocol/servers
292 
293Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make mcp-server-time even more powerful and useful.
294 
295## License
296 
297mcp-server-time is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
298 

Reviews

Installed this one?Write the first review and take the Trailblazer badge.

Reviews only open after a real install, so this is empty — and we leave it empty rather than invent one.

Alternatives

Also in Data & AI