Passage of Time
๐ค๐ฐ๏ธ An MCP server that gives language models temporal awareness and time calculation abilities. Teaching AI the significance of the passage of time through collaborative tool development.
What is Passage of Time?
Passage of Time is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ค๐ฐ๏ธ an mcp server that gives language models temporal awareness and time calculation abilities. teaching ai the significance of the passage of time through collaborative tool development.
๐ค๐ฐ๏ธ An MCP server that gives language models temporal awareness and time calculation abilities. Teaching AI the significance of the passage of time through collaborative tool development.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ๐ค๐ฐ๏ธ An MCP server that gives language models temporal awaren
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx passage-of-timeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Passage of Time
Passage of Time is an MCP server that gives language models genuine temporal awareness by exposing tools for querying the current date and time, calculating durations between timestamps, formatting time intervals, and understanding contextual information about a moment (such as whether it is a weekend or business hours). Without it, LLMs have no access to real-time clock data and cannot reason about deadlines, elapsed time, or scheduling. Developers building scheduling assistants, time-aware chatbots, or productivity tools use this server to ground their AI's temporal reasoning in actual wall-clock time.
Prerequisites
- Python 3.12+ installed
- pipenv or pip for dependency management
- An MCP client such as Claude Desktop or Claude Code
- pytz library (installed automatically via pipenv install)
Clone the repository
Clone the passage-of-time-mcp repository to your local machine.
git clone https://github.com/jlumbroso/passage-of-time-mcp.git
cd passage-of-time-mcpInstall dependencies
Install required Python packages using pipenv. Alternatively, install fastmcp and pytz directly with pip.
pipenv install
# or without pipenv:
pip install fastmcp pytzRun the server
Start the MCP server. It listens on http://0.0.0.0:8000/sse by default.
pipenv run server
# or directly:
pipenv run python passage_of_time_mcp.pyConfigure Claude Desktop
Add the server to your Claude Desktop configuration, pointing to the Python interpreter in your pipenv environment.
{
"mcpServers": {
"passage-of-time": {
"command": "pipenv",
"args": ["run", "python", "passage_of_time_mcp.py"],
"cwd": "/path/to/passage-of-time-mcp"
}
}
}Verify temporal awareness
Ask Claude what the current time is and whether it is a business day to confirm the server is responding with live clock data.
Passage of Time Examples
Client configuration
Claude Desktop configuration for the Passage of Time MCP server using pipenv.
{
"mcpServers": {
"passage-of-time": {
"command": "pipenv",
"args": ["run", "python", "passage_of_time_mcp.py"],
"cwd": "/path/to/passage-of-time-mcp"
}
}
}Prompts to try
Example prompts that use temporal awareness tools for scheduling, elapsed time, and context-aware reasoning.
- "What is the current date and time in New York?"
- "How many days have passed since January 1st this year?"
- "Is right now a good time to send a work email, or is it outside business hours?"
- "How long ago was 2023-06-15 09:00:00 and what day of the week was it?"
- "Add 45 days to today's date and tell me what date that will be"Troubleshooting Passage of Time
pipenv not found when starting the server
Install pipenv with 'pip install pipenv' or 'brew install pipenv' on macOS. Alternatively, install dependencies directly with 'pip install fastmcp pytz' and run 'python passage_of_time_mcp.py' directly.
Server returns wrong timezone
The default timezone is America/New_York. If you need a different timezone, check the server source for a timezone configuration parameter and update it, or pass the desired IANA timezone string in your time queries.
Claude Desktop cannot connect to the SSE server
Ensure the server is running before Claude Desktop starts. The server listens on port 8000 by default. Check that no other process is using port 8000 with 'lsof -i :8000'.
Frequently Asked Questions about Passage of Time
What is Passage of Time?
Passage of Time is a Model Context Protocol (MCP) server that ๐ค๐ฐ๏ธ an mcp server that gives language models temporal awareness and time calculation abilities. teaching ai the significance of the passage of time through collaborative tool development. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Passage of Time?
Follow the installation instructions on the Passage of Time GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Passage of Time?
Passage of Time works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Passage of Time free to use?
Yes, Passage of Time is open source and available under the MPL-2.0 license. You can use it freely in both personal and commercial projects.
Passage of Time Alternatives โ Similar Developer Tools Servers
Looking for alternatives to Passage of Time? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Passage of Time in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Passage of Time?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.