README.md
LM Studio plugin that gives the model access to the current date and time.
Without it, models reply "I don't have access to real time." With it, they can answer "What time is it?" or "What time is it in Tokyo?" with an actual answer.
get_current_time() — returns the current date and time in the user's configured timezone (or the system timezone if none is set).get_date_in(timezone, format?) — returns the current date and time in a specific IANA timezone (e.g. , , ).Asia/TokyoAmerica/New_YorkEurope/LondonBoth tools return a structured object:
The formatted field follows the plugin's configured format.
Per-chat settings, configurable from the plugin panel in LM Studio:
| Field | Type | Default | Notes |
|---|---|---|---|
| Default timezone | string | (system) | IANA name, e.g. Europe/Paris. Empty = system timezone. |
| Default locale | string | (system) | BCP 47 tag, e.g. fr-FR. Empty = system locale. |
| Default format | select | iso | Format for the formatted field: iso, human, or unix. |
One-click (macOS, Windows): Run in LM Studio
Linux (AppImage): the lmstudio:// deep link doesn't work out of the box because the AppImage doesn't register a scheme handler. Use the CLI instead:
To fix the deep link permanently, create ~/.local/share/applications/lmstudio.desktop:
Then:
After install: the plugin isn't enabled in chats by default. In any chat, click the tools button (bottom right of the chat input) and enable current-time.
MIT
{
"local_datetime": "2026-05-05 10:28:00",
"weekday": "Tuesday",
"timezone": "Europe/Paris",
"locale": "fr-FR",
"iso_utc": "2026-05-05T08:28:00.000Z",
"unix_seconds": 1778041680,
"formatted": "2026-05-05T10:28:00+02:00"
}
lms clone zexigh/current-time
cd current-time
lms dev -i # -i / --install: install the plugin into LM Studio
[Desktop Entry]
Name=LM Studio
Exec=/absolute/path/to/LM-Studio.AppImage %u
Type=Application
MimeType=x-scheme-handler/lmstudio;
Categories=Development;
update-desktop-database ~/.local/share/applications/
xdg-mime default lmstudio.desktop x-scheme-handler/lmstudio