Griptape Tool: DateTime

LLMs don't know what day it is. Their training data froze at some point in the past, so if you ask a bare agent "what's today's date?", it will confidently tell you a date from its training cutoff - possibly years ago. The DateTime tool fixes that with the least dramatic mechanism in the whole Griptape pack: it gives the agent a way to query the real clock.

This is one of those nodes that looks almost too dumb to bother with until you actually need it. Then you find out it's quietly essential. Any workflow where the agent has to reason about "today," deadlines, age, how many days until something, or "what was the date three weeks ago" will produce garbage without it. Date-stamped file names, scheduling logic, "how old is a paper from this date" - all of it depends on the agent knowing the actual current date and time.

How it works

The node wraps Griptape's DateTimeTool and returns it as a TOOL_LIST. When your agent decides the task needs a date, it calls the tool, which reads the system clock of the machine ComfyUI is running on and returns the current date and time. That's it - no API, no key, no network. The agent then uses that value in whatever reasoning it's doing. The only subtlety is trusting the machine's clock: if your ComfyUI box has a wrong clock or timezone, that's what the agent reports.

The one input that matters

• off_prompt - default False. Off-prompt behavior is the pack's recurring privacy/cost lever: default off means the tool's output (the date/time) is surfaced to the model, which is what you want here - the whole point is the agent knows the date. Leave it alone unless you're chaining this into a flow where you want the value handled privately.

One output, TOOL (TOOL_LIST), which you connect to your agent's tools.

Install

DateTime comes with the ComfyUI-Griptape pack. Install once, get all the tools:

cd ComfyUI/custom_nodes
git clone https://github.com/griptape-ai/ComfyUI-Griptape

or ComfyUI Manager → search "Griptape" → install, then restart ComfyUI.

Where people get burned

Honestly, the trap here isn't the node - it's expecting a date string to pop out of it. Same as every Griptape tool: the output is a tool the agent calls, not a value for you. You need the chain - DateTime tool wired into an agent, then a prompt like "today is relevant, use your tools" - for it to actually do anything.

The other thing people forget: an LLM will happily answer "what's the date" from its training data instead of calling the tool, especially if your prompt doesn't hint that tools exist. Tell the agent explicitly that it has a date tool and should use it for anything date-related. That's a general lesson for this whole pack - the tools are only as good as the prompting that makes the agent reach for them. DateTime is the cheapest tool in the pack (zero keys, zero cost), so it's a great one to start with when you're learning how agent tools and prompting interact.