DateTime
About
Provides current date and time with configurable formats and timezones.
Details
- Author
- takanarishimbo
- Categories
- Productivity
Jump to
3. Setup GitHub Personal Access Token (for release script)
The release script needs to push to GitHub, so you'll need a GitHub token:
- Create GitHub Personal Access Token
- Go to](https://pypi.org/manage/account/publishing/)https://github.com/settings/tokens
- Click "Generate new token" → "Generate new token (classic)"
- Set expiration (recommended: 90 days or custom)
- Select scopes:
- ✅repo(Full control of private repositories)
- Click "Generate token"
- Copy the generated token (starts withghp_)
# Option 1: Use GitHub CLI (recommended) gh auth login # Option 2: Configure git to use token git config --global credential.helper store # Then when prompted for password, use your token instead
Use the release script to automatically version, tag, and trigger publishing:
# First time setup chmod +x scripts/release.sh # Increment patch version (0.1.0 → 0.1.1) ./scripts/release.sh patch # Increment minor version (0.1.0 → 0.2.0) ./scripts/release.sh minor # Increment major version (0.1.0 → 1.0.0) ./scripts/release.sh major # Set specific version ./scripts/release.sh 1.2.3
- Check GitHub Actions
- Go to "Actions" tab in your repository
- Verify the "Publish to PyPI" workflow completed successfully
- Visit:https://pypi.org/project/takanarishimbo-datetime-mcp-server/
- Or run:pip show takanarishimbo-datetime-mcp-server
- release.shscript updates version in all files
- Creates git commit and tag
- Pushes to GitHub
- GitHub Actions workflow triggers on new tag
- Workflow uses OIDC to authenticate with PyPI (no tokens needed!)
- Workflow builds project and publishes to PyPI
- Package becomes available globally viapip installoruvx
This project usesrufffor linting and formatting:
# Run linter uv run ruff check # Fix linting issues uv run ruff check --fix # Format code uv run ruff format
uvx-datetime-mcp-server/ ├── src/ │ ├── __init__.py # Package initialization │ ├── __main__.py # Main entry point │ └── server.py # Server implementation ├── pyproject.toml # Project configuration ├── uv.lock # Dependency lock file ├── .github/ │ └── workflows/ │ └── pypi-publish.yml # PyPI publish workflow with Trusted Publishers ├── scripts/ │ └── release.sh # Release automation script ├── docs/ │ ├── README.md # This file │ └── README_ja.md # Japanese documentation └── .gitignore # Git ignore file
The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.
This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.
Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.
A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.
Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.
An MCP server for WordPress plugin audits
Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.
Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.
Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar
A Model Context Protocol (MCP) server that provides tools to get the current date and time in various formats. This is a Python implementation of the datetime MCP server, demonstrating how to build MCP servers using the Python SDK.
- Get current date and time in multiple formats (ISO, Unix timestamp, human-readable, etc.)
- Configurable output format via environment variables
- Timezone support
- Custom date format support
- Simple tool:get_current_time
Choose one of these examples based on your needs:
{ "mcpServers": { "datetime": { "command": "uvx", "args": ["takanarishimbo-datetime-mcp-server"] } } }
{ "mcpServers": { "datetime": { "command": "uvx", "args": ["takanarishimbo-datetime-mcp-server"], "env": { "DATETIME_FORMAT": "human", "TIMEZONE": "America/New_York" } } } }
{ "mcpServers": { "datetime": { "command": "uvx", "args": ["takanarishimbo-datetime-mcp-server"], "env": { "DATETIME_FORMAT": "unix", "TIMEZONE": "UTC" } } } }
{ "mcpServers": { "datetime": { "command": "uvx", "args": ["takanarishimbo-datetime-mcp-server"], "env": { "DATETIME_FORMAT": "custom", "DATE_FORMAT_STRING": "%Y/%m/%d %H:%M", "TIMEZONE": "Asia/Tokyo" } } } }
The server can be configured using environment variables:
Controls the default output format of the datetime (default: "iso")
- iso: ISO 8601 format (2024-01-01T12:00:00.000000+00:00)
- unix: Unix timestamp in seconds
- unix_ms: Unix timestamp in milliseconds
- human: Human-readable format (Mon, Jan 1, 2024 12:00:00 PM UTC)
- date: Date only (2024-01-01)
- time: Time only (12:00:00)
- custom: Custom format using DATE_FORMAT_STRING environment variable
Custom date format string (only used when DATETIME_FORMAT="custom") Default: "%Y-%m-%d %H:%M:%S"
Uses Python's strftime format codes:
- %Y: 4-digit year
- %y: 2-digit year
- %m: 2-digit month
- %d: 2-digit day
- %H: 2-digit hour (24-hour)
- %M: 2-digit minute
- %S: 2-digit second
Timezone to use (default: "UTC") Examples: "UTC", "America/New_York", "Asia/Tokyo"
- format(optional): Output format, overrides DATETIME_FORMAT env var
- timezone(optional): Timezone to use, overrides TIMEZONE env var
- Clone this repository
git clone https://github.com/TakanariShimbo/uvx-datetime-mcp-server.git cd uvx-datetime-mcp-server
uv run takanarishimbo-datetime-mcp-server
npx @modelcontextprotocol/inspector uv run takanarishimbo-datetime-mcp-server
This project uses PyPI's Trusted Publishers feature for secure, token-less publishing via GitHub Actions.
- Log in to PyPI(create account if needed)
- Go tohttps://pypi.org/
- Go to your account settings
- Click on "Publishing" or go tohttps://pypi.org/manage/account/publishing/
- Click "Add a new publisher"
- Select "GitHub" as the publisher
- Fill in:
- Owner:TakanariShimbo(your GitHub username/org) -Repository:uvx-datetime-mcp-server-Workflow name:pypi-publish.yml-Environment:pypi(optional but recommended)
- Click "Add"
- Go to your GitHub repository
- Click "Settings" → "Environments"
- Click "New environment"
- Name:pypi
- Configure protection rules (optional):
- Add required reviewers - Restrict to specific branches/tags
3. Setup GitHub Personal Access Token (for release script)
The release script needs to push to GitHub, so you'll need a GitHub token:
- Create GitHub Personal Access Token
- Go tohttps://github.com/settings/tokens
- Click "Generate new token" → "Generate new token (classic)"
- Set expiration (recommended: 90 days or custom)
- Select scopes:
- ✅repo(Full control of private repositories)
- Click "Generate token"
- Copy the generated token (starts withghp_)
# Option 1: Use GitHub CLI (recommended) gh auth login # Option 2: Configure git to use token git config --global credential.helper store # Then when prompted for password, use your token instead
Use the release script to automatically version, tag, and trigger publishing:
# First time setup chmod +x scripts/release.sh # Increment patch version (0.1.0 → 0.1.1) ./scripts/release.sh patch # Increment minor version (0.1.0 → 0.2.0) ./scripts/release.sh minor # Increment major version (0.1.0 → 1.0.0) ./scripts/release.sh major # Set specific version ./scripts/release.sh 1.2.3
- Check GitHub Actions
- Go to "Actions" tab in your repository
- Verify the "Publish to PyPI" workflow completed successfully
- Visit:https://pypi.org/project/takanarishimbo-datetime-mcp-server/
- Or run:pip show takanarishimbo-datetime-mcp-server
- release.shscript updates version in all files
- Creates git commit and tag
- Pushes to GitHub
- GitHub Actions workflow triggers on new tag
- Workflow uses OIDC to authenticate with PyPI (no tokens needed!)
- Workflow builds project and publishes to PyPI
- Package becomes available globally viapip installoruvx
This project usesrufffor linting and formatting:
# Run linter uv run ruff check # Fix linting issues uv run ruff check --fix # Format code uv run ruff format
uvx-datetime-mcp-server/ ├── src/ │ ├── __init__.py # Package initialization │ ├── __main__.py # Main entry point │ └── server.py # Server implementation ├── pyproject.toml # Project configuration ├── uv.lock # Dependency lock file ├── .github/ │ └── workflows/ │ └── pypi-publish.yml # PyPI publish workflow with Trusted Publishers ├── scripts/ │ └── release.sh # Release automation script ├── docs/ │ ├── README.md # This file │ └── README_ja.md # Japanese documentation └── .gitignore # Git ignore file
The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.
This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.
Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.
A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.
Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.
An MCP server for WordPress plugin audits
Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.
Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.
Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



