A comprehensive temporal toolkit for managing global datetimes, IANA timezone conversions, and IP-based geolocation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pipeworx-timezone
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pipeworx-timezone using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Timezone?
The Timezone skill is a robust utility designed for developers and automated agents to navigate the complexities of global time management. By integrating this module into the ecosystem of Openclaw Skills, users gain access to high-precision IANA timezone data, allowing for seamless synchronization across distributed teams and global infrastructures.
Whether you are verifying the current local time in Tokyo or calculating complex offsets between New York and London, this skill provides a standardized MCP-compliant interface. It eliminates the guesswork of daylight savings and UTC offsets, making it an essential component for any time-sensitive automation or scheduling workflow.
Timezone Use Cases
- Scheduling international meetings with precise offset calculations between multiple geographic regions.
- Determining local server or user time based on IP addresses for personalized content delivery.
- Generating comprehensive lists of valid IANA timezone strings for form validation or configuration files.
- Automating logs and event timestamps across different regional contexts.
How Timezone Works
- The agent identifies a temporal requirement, such as a conversion request or a geolocation lookup.
- A call is made to the specific tool (e.g., convert_time or get_time_by_ip) via the Openclaw Skills gateway.
- The skill queries a global database of IANA timezones and geolocation data to retrieve the current datetime or offset.
- The system calculates differences between requested zones, including UTC offsets and local time strings.
- A structured JSON response is returned, providing both the raw datetime and the relative time differences.
Timezone Setup
To integrate this skill into your environment, add the server configuration to your MCP settings file:
{
"mcpServers": {
"timezone": {
"url": "https://gateway.pipeworx.io/timezone/mcp"
" }
}
}
You can test the conversion functionality using a standard curl command:
curl -X POST https://gateway.pipeworx.io/timezone/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_time","arguments":{"from_timezone":"America/New_York","to_timezone":"Europe/London","time":"2025-04-15T09:00:00"}}}'
Timezone Data Schema & Taxonomy
The skill utilizes standard ISO-8601 strings and IANA identifiers to ensure interoperability across Openclaw Skills.
| Attribute | Description | Format |
|---|---|---|
| datetime | The calculated local time | ISO-8601 |
| timezone | The IANA string used for the lookup | e.g., Asia/Tokyo |
| utc_offset | The relative offset from UTC | +/-HH:mm |
| offset_diff | Difference between two specific zones | Hours/Minutes |
Timezone Advanced Features
- Real-time IP-to-timezone geolocation for dynamic user-context awareness.
- Support for "Right Now" conversions by omitting specific time parameters in the convert_time tool.
- High-fidelity offset reporting that includes both source and destination UTC offsets simultaneously.
- Native integration with MCP-compatible IDEs and agentic frameworks via Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Tarot AI Agent Skill
A comprehensive digital tarot deck providing programmatic access to 78 Rider-Waite cards, including upright and reversed meanings.
Translate Skill
A robust machine translation and language identification tool for AI agents powered by the LibreTranslate engine.
TLE Satellite Tracking
A high-precision utility for fetching and searching Two-Line Element (TLE) sets used in satellite tracking and orbital mechanics.
JSON Key Sorter
A command-line utility for Openclaw Skills that automatically alphabetizes JSON object keys to ensure data consistency and simplified version control.
Swiss Transport
A comprehensive MCP tool for accessing real-time Swiss public transport data from SBB and regional operators.
Sunrise & Sunset
A high-precision solar data tool providing sunrise, sunset, and celestial timing for any coordinate on Earth.
Featured*
