Back to Discover

dates-le

connector

nolindnaidoo

Extract dates and timestamps from logs, data files and code, with their format and position.

View on GitHub
0 starsSynced Aug 5, 2026

Install to Claude Code

/plugin marketplace add nolindnaidoo/dates-le

README

Dates-LE Logo

Dates-LE: Zero Hassle Date Extraction

Pull every date and timestamp out of the current file in one keystroke
JSON, YAML, CSV, XML, logs, HTML, JavaScript, and TypeScript

Install from VS Code Marketplace Open VSX downloads dates-le-mcp on npm LE Tools


Dates-LE Demo

Useful? A star or rating is how other developers find it — ★ GitHub · ★ Marketplace · ★ Open VSX

What it does

Open a file, press Ctrl+Alt+D (Cmd+Alt+D on Mac), and every date in the document lands in a new editor — deduplicate, sort, analyze, convert, filter, or validate it from there. Works in VS Code and in VS Code–based editors like Cursor and VSCodium (installable from Open VSX).

  • Log analysis — timestamps from server logs: ISO, syslog, and Apache access-log formats
  • Data review — dates and epochs from JSON, YAML, CSV, and XML
  • Code audit — date literals and new Date()/Date.parse()/moment()/dayjs()/DateTime.fromISO() arguments in JS/TS, including calls formatted across multiple lines

Use it from an AI agent

The same engine runs as an MCP server, so an agent can call it directly instead of you running a command.

EditorHow
VS Code 1.101+Nothing to install — the extension registers extract_dates with agent mode
ZedDates-LEpending review
Claude Codeclaude mcp add dates-le -- npx -y dates-le-mcp
Cursor, Windsurf, anything elsepoint it at npx dates-le-mcp
extract_dates(content, format?, filename?, dedupe?, maxResults?)

Returns every date with its notation, epoch value where resolvable, and 1-based line and column, capped at 500 by default with meta.truncated.

The server takes content and returns data — it reads no files and makes no network requests of its own. Published as dates-le-mcp on npm and as io.github.nolindnaidoo/dates-le in the MCP registry.

Configuring it by hand — any host with an MCP config file

Most hosts read a JSON config. Add one entry:

{
  "mcpServers": {
    "dates-le": {
      "command": "npx",
      "args": ["-y", "dates-le-mcp"]
    }
  }
}

-y skips the install prompt on first run. Pin a version if you would rather not track releases — dates-le-mcp@2.2.1.

Prefer not to go through npx on every launch? Install it once and point at the binary instead:

npm install -g dates-le-mcp
{
  "mcpServers": {
    "dates-le": { "command": "dates-le-mcp" }
  }
}

It speaks MCP over stdio and needs no environment variables, no API key and no configuration of its own. To check it before wiring it into anything:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y dates-le-mcp

That prints the tool list and exits — if you see extract_dates, the server works.

Supported formats

FormatLanguage IDsWhat gets extracted
JSONjsonEvery recognized date pattern in the content
YAMLyaml, ymlEvery recognized date pattern in the content
CSVcsvEvery recognized date pattern, cell by cell
XMLxmlDate patterns outside comments (inline and multiline comments are skipped)
Log / plain textlog, plaintextEverything above plus YYYY-MM-DD HH:mm:ss log lines, syslog (Mon DD HH:mm:ss), and Apache access-log timestamps
JavaScript / TypeScriptjavascript, javascriptreact, typescript, typescriptreactEverything above plus string arguments to new Date(), Date.parse(), moment(), dayjs(), DateTime.fromISO()
HTMLhtmlEverything above plus datetime attributes, date-bearing <meta> tags, and JSON-LD datePublished/dateModified

Recognized date patterns: ISO 8601 (2024-01-15T10:30:00Z, with optional milliseconds and offset), RFC 2822 (Mon, 15 Jan 2024 10:30:00 GMT), Unix epochs (exactly 10 or 13 digits in a plausible range — digits embedded in longer numbers are never matched), UTC strings, US-style M/D/YYYY HH:mm:ss, and bare YYYY-MM-DD. Every occurrence is reported with its real line and column. Values that cannot be parsed to a timestamp are not extracted.

Known limitations: M/D/YYYY assumes US ordering; syslog lines carry no year, so the current year is assumed.

Commands

CommandDescription
Dates-LE: Extract Dates (Ctrl+Alt+D / Cmd+Alt+D)Extract all dates from the active document
Dates-LE: Analyze DatesStatistics, patterns, clusters, gaps, and anomalies
Dates-LE: Convert DatesConvert extracted dates to ISO, RFC 2822, Unix, UTC, local, simple, or a custom format
Dates-LE: Filter DatesFilter by range, format, duplicates, future/past
Dates-LE: Validate DatesCheck extracted dates against selectable rules
Dates-LE: Deduplicate DatesRemove duplicate lines from the results
Dates-LE: Sort DatesSort results chronologically or alphabetically
Dates-LE: Open SettingsOpen Dates-LE settings
Dates-LE: HelpBuilt-in documentation

Settings

SettingDefaultDescription
dates-le.openResultsSideBySidetrueOpen results beside the current editor
dates-le.copyToClipboardEnabledfalseAlso copy results to the clipboard
dates-le.notificationsLevelsilentall = every notification, important = warnings + errors, silent = errors only
dates-le.safety.enabledtrueGuardrails for very large files
dates-le.safety.fileSizeWarnBytes1000000Refuse extraction above this file size
dates-le.statusBar.enabledtrueShow the status bar item
dates-le.telemetryEnabledfalseLocal-only event log (see Privacy)

Languages

Twelve languages besides English:

German · Spanish · French · Indonesian · Italian · Japanese · Korean · Portuguese (Brazil) · Russian · Ukrainian · Vietnamese · Chinese (Simplified)

Both halves are covered — the manifest (command titles, setting names and descriptions) and everything shown while the extension runs (notifications, the status bar, quick-picks and prompts). The extension follows VS Code's display language, so it matches whatever the editor is already set to; no setting of its own.

Privacy & security

  • No network access. The extension never sends data anywhere. The telemetryEnabled setting only writes events to a local Output Channel you can inspect (Dates-LE Telemetry).
  • The MCP server holds the same line. It takes content as an argument and returns data: no filesystem access, no network calls, no telemetry. Your agent already has file-read tools, so duplicating them inside the server would add a path-traversal surface for no capability. check:mcp-bundle fails the build if the server ever imports something that could reach either.
  • Error notifications redact home directories and credential-shaped fragments.

Development

bun install
bun run build            # esbuild bundle -> dist/extension.js
bun run typecheck        # tsc --noEmit (includes tests)
bun run test             # vitest unit suite
bun run test:integration # real VS Code extension host
bun run lint             # biome
bun run package          # VSIX into release/

Architecture and conventions live in AGENTS.md. Changes are tracked in CHANGELOG.md.

Performance

InputSizeFoundTimeRateScan speed
Server log (ISO)1.74 MB40,000139.92 ms285,887/sec12.5 MB/s
JSON records1.42 MB25,00082.75 ms302,132/sec17.2 MB/s
CSV export0.64 MB40,00039.15 ms1,021,610/sec16.3 MB/s

Median of 7 runs after warmup, on Apple M5 Pro, 24 GB RAM, Node 24.3.0. Inputs are generated by scripts/benchmark.ts rather than checked in, so the sizes above are exactly what was measured. Reproduce with bun run benchmark.

These are machine-specific and are not asserted in CI — a benchmark that gates a build only tells you how busy the runner was.

Testing

MetricCoverage
Statements91.27%
Branches79.00%
Functions96.12%
Lines92.66%

189 test cases across 17 files, plus an integration suite that runs in a real VS Code extension host and an end-to-end test that installs the built .vsix into a clean profile.

Generated from coverage/coverage-summary.json by scripts/coverage-readme.js; CI fails if this section drifts from a fresh run. Reproduce with bun run test:coverage.

More from the LE Family

Every tool in the family, one page: letools.dev

All ten also ship as MCP servers — npx <name>-mcp gives any agent the same engine.

  • Paths-LE - Extract file paths from JS/TS imports, JSON, HTML, CSS, TOML, CSV, and .env
  • String-LE - Extract string values for i18n from JSON, YAML, CSV, TOML, INI, and .env
  • Numbers-LE - Extract numeric values from JSON, YAML, CSV, TOML, INI, and .env
  • EnvSync-LE - Spot missing keys across your .env files, with a markdown report
  • Regex-LE - Find, test, and validate regular expressions with ReDoS screening
  • Secrets-LE - Detect and sanitize credentials locally, before you commit
  • Scrape-LE - Check whether a page is scrapeable before you write the scraper
  • Colors-LE - Extract and analyze colors from CSS, SCSS, LESS, Stylus, HTML, JS/TS, and SVG
  • URLs-LE - Extract URLs from documentation, configs, and code

Also by nolindnaidoo

Rust

Contact DeveloperGitHub · LinkedIn

License

MIT © nolindnaidoo

Rendered live from nolindnaidoo/dates-le's GitHub README — not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
npm packageInstall via npm (stdio transport)mcp-serverdates-le-mcp

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.