Timezone MCP Tools for AI Agents

"What time is it in Tokyo when it's 3 PM in New York?" Your agent needs to know if daylight saving time is active, what the current UTC offset is for both zones, and handle the date line. These tools make timezone conversion reliable.

All Timezone Tools (17)

Your agent gets access to 17 timezone tools via the /mcp/time/ endpoint. Here's the complete list:

Tool	Description
`time/now`	Current Time
`time/convert`	Convert Timezone
`time/difference`	Time Difference
`time/add`	Add Time
`time/subtract`	Subtract Time
`time/start-of`	Start Of Period
`time/end-of`	End Of Period
`time/is-leap-year`	Is Leap Year
`time/days-in-month`	Days In Month
`time/week-number`	Week Number
`time/quarter`	Get Quarter
`time/business-days`	Business Days
`time/add-business-days`	Add Business Days
`time/age`	Calculate Age
`time/timezones`	List Timezones
`time/unix-to-datetime`	Unix To Datetime
`time/datetime-to-unix`	Datetime To Unix

Agent Scenarios

Here's how real agents use these tools:

1. Meeting scheduler agent

A scheduling agent finds overlapping working hours between New York and Tokyo offices. time/convert handles DST correctly.

Tool Call: time/convert

{ "time": "15:00", "from": "America/New_York", "to": "Asia/Tokyo" }

2. Global notification agent

A messaging agent schedules notifications at 9 AM local time for users across different timezones.

Tool Call: time/now

{ "timezone": "Europe/London" }

3. Travel booking agent

A travel agent calculates arrival times accounting for timezone changes during flights.

Tool Call: time/convert

{ "time": "2026-02-15T14:00:00", "from": "America/Los_Angeles", "to": "Europe/Paris" }

MCP Setup

Add timezone tools to your agent in under 2 minutes. Choose your client:

Claude Desktop / Claude Code

Add this to your MCP config:

{
  "mcpServers": {
    "tinyfn-time": {
      "url": "https://api.tinyfn.io/mcp/time/",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Cursor

Go to Settings > MCP and add a new server:

Type: SSE
URL: https://api.tinyfn.io/mcp/time/sse
Headers: X-API-Key: your-api-key

Tip: Use the category-specific endpoint (/mcp/time/) for the best experience. The all-in-one endpoint (/mcp/all/) works too but has 500+ tools which some clients handle less efficiently.

When to Use These Tools

Use timezone MCP tools when your agent needs to:

Guarantee correctness — when wrong answers have real consequences
Process user data — when you're operating on actual user input, not hypothetical examples
Maintain consistency — when the same input must always produce the same output

You don't need these tools for casual conversation or rough estimates. Use them when precision matters.

Ready to add timezone tools to your agent?

Get Free API Key 100 requests/month free. No credit card required.

Frequently Asked Questions

How does TinyFn handle daylight saving time?

TinyFn uses the IANA timezone database (via Python's zoneinfo), which includes all DST transition rules. Conversions automatically account for whether DST is active at the specified time.

What timezone formats are supported?

TinyFn uses IANA timezone identifiers (e.g., America/New_York, Asia/Tokyo, Europe/London). Common abbreviations are also mapped to their full identifiers.

Can TinyFn handle historical timezone changes?

Yes. The IANA database includes historical timezone data, so conversions for past dates use the rules that were in effect at that time.