# Get Users Current Time / Date

## Links

- Product page URL: https://www.agentpmt.com/marketplace/user-timezone-datetime
- Product markdown URL: https://www.agentpmt.com/marketplace/user-timezone-datetime?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/user-timezone-datetime?format=agent-json

## Overview

- Product ID: 6987b3363a2127a981e41238
- Type: core utility
- Unit type: request
- Price: 300 credits
- Categories: Automation, Date & Time Utilities, Meeting & Calendar Scheduling, Time Tracking & Resource Planning, Appointment & Scheduling
- Generated at: 2026-07-05T10:21:57.357Z

### Page Description

Agents running in the cloud don't know what timezone their users are in. This tool returns the current date and time in the user's configured timezone so agents can schedule, format, and reason about time using the user's local context. The tool returns both local and UTC timestamps, the timezone name, and useful derived fields such as local date, local time, and UTC offset. This enables time aware workflows like reminders, deadlines, and calendar or messaging logic without repeatedly asking the user what time zone they are in.

### Agent Description

Get the user's current date and time in their configured timezone.

## Details

### Details

Agents running in the cloud don't know what timezone their users are in. This tool returns the current date and time in the user's configured timezone so agents can schedule, format, and reason about time using the user's local context. The tool returns both local and UTC timestamps, the timezone name, and useful derived fields such as local date, local time, and UTC offset. This enables time aware workflows like reminders, deadlines, and calendar or messaging logic without repeatedly asking the user what time zone they are in.

### Actions

- `get_current_datetime` (3 credits): Returns the current local datetime, UTC datetime, and derived fields (local date, local time, UTC offset, DST status) based on the user's configured timezone.

### Use Cases

Get current local time for a user, Build time aware reminders, Schedule messages in the user timezone, Add local timestamps to logs, Convert between UTC and user local time, Validate timezone configuration, Generate date strings for reports

### Workflows Using This Tool

#### Appointment Scheduling and Route Planner

Takes a CSV or spreadsheet file with addresses, asks for a starting drive time, time per stop, and starting address, then parses the addresses, optimizes the driving route, calculates estimated arrival and departure times for each location, and generates a CSV with the full schedule. Returns the optimized route map, Google Maps directions link, and the schedule CSV both locally and via notification. Ideal for field sales, service technicians, delivery planning, or any multi-stop appointment scheduling.

- Page URL: https://www.agentpmt.com/agent-workflow-skills/appointment-scheduling-and-route-planner
- Markdown URL: https://www.agentpmt.com/agent-workflow-skills/appointment-scheduling-and-route-planner?format=agent-md
- Published: 2026-04-19T18:29:42.593Z

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp#platform=claude
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp#platform=chatgpt
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp#platform=cursor
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp#platform=windsurf

Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6987b3363a2127a981e41238",
    "parameters": {
      "action": "get_current_datetime"
    }
  }'
```

### Autonomous Agents

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

- Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents
- Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md
- Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress
- AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls.
- Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state.
- Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche.

#### Product Skill Package

This product has a published Agent Skill package for product-specific operating instructions.

- Skill slug: get-users-current-time-date
- Version: 1.0.0
- Download SKILL.md: https://raw.githubusercontent.com/AgentPMT/agent-skills/main/skills/get-users-current-time-date/SKILL.md
- Package source: https://github.com/AgentPMT/agent-skills/tree/main/skills/get-users-current-time-date
- OpenClaw listing: https://clawhub.ai/agentpmt/get-users-current-time-date
- OpenClaw install: `openclaw skills install get-users-current-time-date`
- skills.sh install: `npx skills add AgentPMT/agent-skills --skill get-users-current-time-date`
- Last published: 2026-06-24T08:26:38.741Z

### Schema

#### Credentials

These runtime credentials should be provided under `parameters._credentials` when required.

- User Timezone (`user_timezone`, other, required)
  Help: Select your IANA timezone (e.g. US/Eastern, Europe/London, Asia/Tokyo).
  Connection ID: 698d297d2b32918aa8fe5590

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "get_current_datetime": {
      "description": "Returns the current local datetime, UTC datetime, and derived fields (local date, local time, UTC offset, DST status) based on the user's configured timezone."
    }
  }
}
```

### Usage Instructions

# User Timezone DateTime

Returns the current date and time based on the user's configured timezone setting. Uses IANA timezone names (e.g., "America/New_York", "Europe/London") to provide accurate local time with UTC offset, DST detection, and formatted date/time components.

## Actions

### get_current_datetime

Returns the current local datetime, UTC datetime, and derived fields for the user's configured timezone.

**Required Parameters:** None (timezone is automatically injected from the user's account settings)

**Response Fields:**
- `timezone` (string) -- IANA timezone name used (e.g., "America/Chicago")
- `utc_datetime` (string) -- Current UTC datetime in ISO 8601 format
- `local_datetime` (string) -- Current local datetime in ISO 8601 format
- `local_date` (string) -- Local date in YYYY-MM-DD format
- `local_time` (string) -- Local time in HH:MM:SS format
- `utc_offset` (string) -- UTC offset formatted as "+HH:MM" or "-HH:MM"
- `utc_offset_minutes` (integer) -- UTC offset in total minutes
- `is_dst` (boolean or null) -- Whether daylight saving time is currently active

**Example Request:**
```json
{
  "action": "get_current_datetime"
}
```

**Example Response:**
```json
{
  "action": "get_current_datetime",
  "timezone": "America/New_York",
  "utc_datetime": "2026-03-10T18:30:00+00:00",
  "local_datetime": "2026-03-10T14:30:00-04:00",
  "local_date": "2026-03-10",
  "local_time": "14:30:00",
  "utc_offset": "-04:00",
  "utc_offset_minutes": -240,
  "is_dst": true
}
```

## Workflows

1. **Check current time before scheduling** -- Call `get_current_datetime` to determine the user's current local time before creating calendar events or setting reminders.
2. **Time-aware greetings** -- Use `local_time` to provide contextual greetings (good morning/afternoon/evening) based on the user's actual local time.
3. **Cross-timezone coordination** -- Use `utc_datetime` and `utc_offset` together to help users coordinate meetings across different timezones.
4. **DST awareness** -- Check the `is_dst` field to inform users about daylight saving time status when scheduling recurring events.

## Notes

- The user's timezone is automatically provided from their account settings; no manual timezone input is needed.
- If the user has not configured a timezone, the request will fail with a validation error ("User timezone is required").
- All IANA timezone names are supported (e.g., "US/Eastern", "Asia/Tokyo", "Pacific/Auckland").
- The `is_dst` field may return `null` for timezones that do not observe daylight saving time.
- UTC offset is provided in both human-readable string format and numeric minutes for programmatic use.

### Frequently Asked Questions

#### How do I connect this tool to an external agent?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

You can install the local MCP server by opening a terminal and running:

```
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

```
{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}
```

[View MCP Connection Instructions](/docs/mcp-reference/connection) for more details.

#### How does an external agent use this tool?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

> Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get\_instructions' so you know how to use the tool search interface. Then call action 'get\_schema' with tool\_id 6987b3363a2127a981e41238 ("Get Users Current Time / Date"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

### Dependencies

This product has no public dependency products.