Provides a customizable web component for time selection via clock faces, scroll wheels, or keyboard input.
Also known as pglejzer/timepicker-ui, timepicker-ui
- Stars
- 102
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- 2.2.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is timepicker-ui MCP?
timepicker-ui provides a customizable web component for time selection via clock faces, scroll wheels, or keyboard input. It exposes 17 tools, such as list_themes, list_modes, list_plugins.
Summary generated from the project's README
About timepicker-ui MCP server
This library provides a customizable web component for time selection that attaches directly to standard HTML input elements. It is designed for web developers building forms that require user-friendly time entry via clock faces, scroll wheels, or keyboard input. The component is framework-agnostic, meaning it works with plain JavaScript, React, Vue, Angular, or Svelte, and is safe for server-side rendering environments like Next.js or Nuxt because it does not touch the window or document object upon import.
Users can choose from several interaction modes including a clock, a wheel, or a compact wheel dropdown. The package is highly modular, allowing developers to import specific plugins for time ranges, timezones, or wheel functionality to keep bundle sizes small. It includes built-in support for accessibility through screen reader labels and keyboard navigation. Developers can customize the appearance using twelve different themes such as Material, Cyberpunk, or Dark, and can implement logic to disable specific times using a custom function.
What you can do with it
- 1Implement time selection in formsAttach a visual time picker to a standard text input for user convenience.
Written from the project's README. Every use case is checked against a quote from it.
How to install timepicker-ui MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall timepicker-ui MCP in Claude Code
$ claude mcp add timepicker-ui -- npx -y timepicker-ui-mcpInstall timepicker-ui MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"timepicker-ui": {
"command": "npx",
"args": [
"-y",
"timepicker-ui-mcp"
]
}
}
}Install timepicker-ui MCP in VS Code
.vscode/mcp.json
{
"servers": {
"timepicker-ui": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"timepicker-ui-mcp"
]
}
}
}Install timepicker-ui MCP in VS Code CLI
$ code --add-mcp '{"name":"timepicker-ui","type":"stdio","command":"npx","args":["-y","timepicker-ui-mcp"]}'Install timepicker-ui MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"timepicker-ui": {
"command": "npx",
"args": [
"-y",
"timepicker-ui-mcp"
]
}
}
}Install timepicker-ui MCP in Codex
$ codex mcp add timepicker-ui -- npx -y timepicker-ui-mcpInstall timepicker-ui MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.timepicker-ui] command = "npx" args = ["-y", "timepicker-ui-mcp"]
Install timepicker-ui MCP in Gemini CLI
$ gemini mcp add -s user timepicker-ui npx -- -y timepicker-ui-mcpInstall timepicker-ui MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"timepicker-ui": {
"command": "npx",
"args": [
"-y",
"timepicker-ui-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for timepicker-ui-mcp 2.2.0 in an isolated container with no network and no keys. It answered and listed 17 tools.
timepicker-ui MCP tools 17
Read from the server with tools/listlist_themesRead-onlyLists the 12 built-in themes with their CSS import paths. Select one with ui.theme. For a custom look use ui.cssClass (see generate_custom_theme).
list_modesRead-onlyLists the UI modes (clock, wheel, compact-wheel) and which plugin each needs.
list_pluginsRead-onlyLists the optional plugins (range, timezone, wheel) with import paths and the option that turns each on.
list_eventsRead-onlyLists the events picker.on(event, handler) can subscribe to, with the payload type and its fields, extracted from source. Internal and deprecated events are left out unless asked for.
list_apiRead-onlyLists the TimepickerUI instance and static methods with signatures, deprecations, and the getValue/setValue contract.
list_css_classesRead-onlyLists the tp-ui- class names and state modifiers, with an example selector for each styled class. Prefer --tp- variables; class names change in 5.0.
list_css_variablesRead-onlyLists the --tp- CSS custom properties with group, default value and whether built-in themes override them. Variables no rule reads are left out unless asked for.
get_optionsRead-onlyReturns the grouped options reference (clock, ui, labels, behavior, callbacks, timezone, range, wheel, clearBehavior) with type, default, description and nested fields, extracted from options.d.ts. Deprecated options are left out unless asked for. Pass a group to narrow it.
explain_optionRead-onlyReturns the full detail (type, default, description, example, deprecation, nested fields) for one option. Use a dotted name for nested fields, e.g. "disabledTime.ranges".
get_themeRead-onlyReturns the --tp- CSS variables a built-in theme sets, with their values, to start a custom theme from.
framework_recipeRead-onlyReturns an integration recipe (lifecycle, SSR notes and code) for vanilla, react, react-wrapper (timepicker-ui-react), next, vue, angular or svelte.
migration_guideRead-onlyReturns migration guidance. "v3->v4": flat to grouped option mapping. "v4.3->v4.4" and "v4.4->v4.5": non-breaking changes, with every renamed option. "v4.6->v4.7": new API and the ARIA, event and theme changes to check. "v4.5->v5": draft list of what 5.0 removes and changes, and the steps that work on 4.5.0 today.
| list_themes | Lists the 12 built-in themes with their CSS import paths. Select one with ui.theme. For a custom look use ui.cssClass (see generate_custom_theme). | Read-only |
| list_modes | Lists the UI modes (clock, wheel, compact-wheel) and which plugin each needs. | Read-only |
| list_plugins | Lists the optional plugins (range, timezone, wheel) with import paths and the option that turns each on. | Read-only |
| list_events | Lists the events picker.on(event, handler) can subscribe to, with the payload type and its fields, extracted from source. Internal and deprecated events are left out unless asked for. | Read-only |
| list_api | Lists the TimepickerUI instance and static methods with signatures, deprecations, and the getValue/setValue contract. | Read-only |
| list_css_classes | Lists the tp-ui- class names and state modifiers, with an example selector for each styled class. Prefer --tp- variables; class names change in 5.0. | Read-only |
| list_css_variables | Lists the --tp- CSS custom properties with group, default value and whether built-in themes override them. Variables no rule reads are left out unless asked for. | Read-only |
| get_options | Returns the grouped options reference (clock, ui, labels, behavior, callbacks, timezone, range, wheel, clearBehavior) with type, default, description and nested fields, extracted from options.d.ts. Deprecated options are left out unless asked for. Pass a group to narrow it. | Read-only |
| explain_option | Returns the full detail (type, default, description, example, deprecation, nested fields) for one option. Use a dotted name for nested fields, e.g. "disabledTime.ranges". | Read-only |
| get_theme | Returns the --tp- CSS variables a built-in theme sets, with their values, to start a custom theme from. | Read-only |
| framework_recipe | Returns an integration recipe (lifecycle, SSR notes and code) for vanilla, react, react-wrapper (timepicker-ui-react), next, vue, angular or svelte. | Read-only |
| migration_guide | Returns migration guidance. "v3->v4": flat to grouped option mapping. "v4.3->v4.4" and "v4.4->v4.5": non-breaking changes, with every renamed option. "v4.6->v4.7": new API and the ARIA, event and theme changes to check. "v4.5->v5": draft list of what 5.0 removes and changes, and the steps that work on 4.5.0 today. | Read-only |
Show all 17 toolsShow fewer tools
generate_snippetRead-onlyGenerates a ready-to-paste vanilla JS or React snippet wiring up TimepickerUI with the chosen theme, mode, clock type, seconds and plugins (CSS imports and plugin registration included). For full framework lifecycle and SSR notes, use framework_recipe.
generate_custom_themeRead-onlyWrites the CSS for a custom theme applied with ui.cssClass: a .tp-ui-wrapper.<name> block of --tp- variables. Pass `overrides` to emit only those, or leave it empty for an editable scaffold of the variables built-in themes change. Unknown variables and variables no rule reads are reported.
validate_timeRead-onlyValidates a time string against a 12h or 24h clock and returns the parsed parts. Accepts "HH:MM", "HH:MM:SS", "h:MM AM/PM" and "h:MM:SS AM/PM".
validate_disabled_timeRead-onlyValidates a clock.disabledTime config: hours, minutes and seconds lists, and range strings in ranges ("10:00 AM - 12:00 PM", "10:00:30 - 10:05"). Returns per-issue feedback.
search_referenceRead-onlyKeyword search across options (including nested fields), events, CSS variables, CSS classes, methods, themes and troubleshooting entries. Use it when you do not know the exact name. Pass a few keywords, not a sentence, e.g. "disable time range", "focus ring color" or "seconds increment". Deprecated items rank lower and are flagged.
| generate_snippet | Generates a ready-to-paste vanilla JS or React snippet wiring up TimepickerUI with the chosen theme, mode, clock type, seconds and plugins (CSS imports and plugin registration included). For full framework lifecycle and SSR notes, use framework_recipe. | Read-only |
| generate_custom_theme | Writes the CSS for a custom theme applied with ui.cssClass: a .tp-ui-wrapper.<name> block of --tp- variables. Pass `overrides` to emit only those, or leave it empty for an editable scaffold of the variables built-in themes change. Unknown variables and variables no rule reads are reported. | Read-only |
| validate_time | Validates a time string against a 12h or 24h clock and returns the parsed parts. Accepts "HH:MM", "HH:MM:SS", "h:MM AM/PM" and "h:MM:SS AM/PM". | Read-only |
| validate_disabled_time | Validates a clock.disabledTime config: hours, minutes and seconds lists, and range strings in ranges ("10:00 AM - 12:00 PM", "10:00:30 - 10:05"). Returns per-issue feedback. | Read-only |
| search_reference | Keyword search across options (including nested fields), events, CSS variables, CSS classes, methods, themes and troubleshooting entries. Use it when you do not know the exact name. Pass a few keywords, not a sentence, e.g. "disable time range", "focus ring color" or "seconds increment". Deprecated items rank lower and are flagged. | Read-only |
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablepglejzer/timepicker-ui is public and reachablegithub.com/pglejzer/timepicker-ui ↗Pass
- Package names this repository as its sourcetimepicker-ui-mcp names pglejzer/timepicker-ui as sourcenpmjs.com/package/timepicker-ui-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for timepicker-ui-mcpnpmjs.com/package/timepicker-ui-mcp/v/2.2.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/pglejzer/timepicker-ui ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from timepicker-ui-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubtimepicker-ui
A time picker for web forms. Attach it to an <input> and users pick a time on a clock face or a scroll wheel.
Live demo · Documentation · Changelog · React wrapper
Why timepicker-ui
- Zero dependencies.
- ~29 KB gzipped core. The range plugin is about 7 KB, the timezone plugin about 3 KB, the wheel plugin about 10 KB, and a plugin only gets bundled if you import it (bundle stats).
- Clock, wheel or compact wheel (a small dropdown under the input).
- Plain JS API, so it works the same in React, Vue, Angular, Svelte or without a framework.
- Doesn't touch
windowordocumenton import, so it's safe in Next.js, Nuxt and other SSR setups. - Keyboard and screen reader support. All texts, the screen-reader ones included, can be translated via
labels.
Features
- 12h / 24h, hour and minute steps, disabled times
- Optional seconds (
HH:MM:SS) in the clock, wheel and compact wheel - 12 themes (Material 2/3, Crane, Dark, Cyberpunk, Blueprint, ...)
- Inline mode (with an embedded variant for your own dialog), clear button, mobile layout
- Time ranges (linked or independent From/To, in the clock, wheel and compact wheel) and timezones via plugins
- Disable times with a function (
clock.isTimeDisabled) - TypeScript types included
Installation
npm install timepicker-ui
Quick start
<input id="timepicker" type="text" />
import { TimepickerUI } from "timepicker-ui";
import "timepicker-ui/main.css";
const input = document.querySelector("#timepicker");
const picker = new TimepickerUI(input, {
clock: { type: "24h" },
ui: { theme: "dark" },
callbacks: {
onConfirm: (data) => console.log("Selected:", data),
},
});
picker.create();
No global CSS reset is needed: the picker sets box-sizing: border-box on its own elements (details).
API
picker.create(); // render the picker and attach it to the input
picker.open();
picker.close();
picker.destroy();
picker.getValue(); // { hour, minutes, seconds, type, time }, seconds only with clock.showSeconds
picker.setValue("14:30"); // "2:30 PM" works too
picker.setValue("14:30:15"); // with clock.showSeconds
picker.setOptions({ ui: { theme: "crane" } });
picker.setRange({ from: "09:00", to: "17:00" }); // needs RangePlugin
picker.getRange();
picker.setActivePart("to");
picker.getActivePart(); // "from", "to" or null
picker.setRangeCaptions({ from: "Mon", to: "Tue" }); // needs RangePlugin
picker.setView("keyboard"); // or "clock"
picker.getView();
picker.clear();
picker.refreshDisabledTime(); // after the data behind clock.isTimeDisabled changes
const off = picker.on("confirm", (data) => {}); // on() and once() return a function that removes the handler
off();
picker.on("confirm", (data) => {});
picker.on("cancel", (data) => {});
picker.on("open", () => {});
picker.on("update", (data) => {});
picker.on("clear", (data) => {});
picker.on("error", (data) => {});
picker.once("confirm", handler);
picker.off("confirm", handler);
TimepickerUI.getById("my-id");
TimepickerUI.getAllInstances();
TimepickerUI.isAvailable("#timepicker");
TimepickerUI.destroyAll();
import { parseTime, formatTime, createDisabledTimeCheck } from "timepicker-ui"; // no picker needed
Options
Grouped by area. Pass only what you need, the rest has defaults (full list).
new TimepickerUI(input, {
clock: {
type: "12h" | "24h" | "auto", // default "12h"; "auto" follows the browser locale
incrementHours: 1,
incrementMinutes: 1,
showSeconds: false, // true adds seconds (HH:MM:SS)
incrementSeconds: 1,
disabledTime: { hours: [], minutes: [], seconds: [], ranges: "" },
isTimeDisabled: ({ hour, minutes, seconds }) => false, // hour is 0-23
defaultTime: "now" | { time, updateInput },
},
ui: {
theme: "basic" | "dark" | "m3-green" | "crane" | "blueprint" | ...,
mode: "clock" | "wheel" | "compact-wheel", // default "clock"
animation: true,
backdrop: true,
initialView: "clock", // or "keyboard"
editable: false,
inline: { enabled: false, container: "#picker" | element, showButtons: false, autoUpdate: false, embedded: false, showTitle: true },
clearButton: false, // or { clearInput: false } to keep the input value on Clear
cssClass: "",
},
labels: { am, pm, ok, cancel, clear, clockTitle, hour, minute, second, valueText, rangeFrom, rangeTo, timezone, ... },
behavior: { focusTrap: true, returnFocus: false, delayHandler: 0, id: "" },
callbacks: { onConfirm, onCancel, onOpen, onUpdate, onSelectHour, onSelectMinute, onSelectSecond, onSelectPeriod, onClear, onError, ... },
wheel: { placement: "auto" | "top" | "bottom", hideFooter: false, commitOnScroll: false, hideDisabled: false, ignoreOutsideClick: false },
range: { enabled: false, linked: true, minDuration, maxDuration },
timezone: { enabled: false, default, list },
});
Themes
Preview all of them: basic, crane, crane-straight, m3-green, m2, dark, glassmorphic, pastel, ai, cyberpunk, blueprint, blueprint-dark.
main.css is required and already includes basic. The rest are separate files:
import "timepicker-ui/main.css";
import "timepicker-ui/theme-dark.css";
new TimepickerUI(input, { ui: { theme: "dark" } });
Or import timepicker-ui/index.css to get all of them. Writing your own theme: styling guide.
Plugins
Range, timezone and wheel ship as separate imports. Register them once before creating pickers. You need WheelPlugin for the wheel and compact-wheel modes.
import { TimepickerUI, PluginRegistry } from "timepicker-ui";
import { RangePlugin } from "timepicker-ui/plugins/range";
import { TimezonePlugin } from "timepicker-ui/plugins/timezone";
import { WheelPlugin } from "timepicker-ui/plugins/wheel";
PluginRegistry.register(RangePlugin);
PluginRegistry.register(TimezonePlugin);
PluginRegistry.register(WheelPlugin);
new TimepickerUI(input, { range: { enabled: true } });
Registration is global. Call PluginRegistry.register() once, before you create pickers. Every picker created afterwards gets a small manager for each registered plugin.
- A plugin does nothing unless the picker turns it on:
range.enabled,timezone.enabled, orui.modeset to'wheel'or'compact-wheel'. - A plugin registered after a picker was created is not available to that picker. Create the picker again.
- Turning a feature on without its plugin registered emits
error.
Without a bundler, load the core UMD build and the plugin UMD builds you need. The core build exposes TimepickerUI.PluginRegistry.
<script src="https://cdn.jsdelivr.net/npm/timepicker-ui@4.7.0/dist/index.umd.js"></script>
<script src="https://cdn.jsdelivr.net/npm/timepicker-ui@4.7.0/dist/plugins/range.umd.js"></script>
<script>
TimepickerUI.PluginRegistry.register(TimepickerUIRange.RangePlugin);
new TimepickerUI('#timepicker', { range: { enabled: true } }).create();
</script>
The plugin globals are TimepickerUIRange.RangePlugin, TimepickerUITimezone.TimezonePlugin and TimepickerUIWheel.WheelPlugin.
Upgrading
From 4.6, 4.7 adds the range plugin in wheel and compact-wheel, setView() / getView(), clear(), getActivePart(), setRangeCaptions() and the range:change event. Some defaults changed: AM/PM is a radiogroup, the timezone combobox moved to .tp-ui-timezone-selected, aria-valuetext reads "7 of 12", and dark follows Material Design 3 tokens. The CHANGELOG lists them under "Check before upgrading".
From 4.5 to 4.6 nothing breaks. 4.6 adds ui.inline.embedded, range.linked, clock.isTimeDisabled with refreshDisabledTime(), the setRange() / getRange() / setActivePart() methods, and a remover returned by on() / once(). See the CHANGELOG.
From 4.4, 4.5 adds optional seconds (clock.showSeconds) and fixes many bugs. It also renames many options to clearer names, for example ui.initialView instead of ui.mobile, and adds setOptions() in place of update(). The old names keep working until 5.0, and the options page lists every pair. A few changes can affect an existing setup: the AM/PM part of the value is always AM / PM whatever labels.am / labels.pm say, out-of-range clock.disabledTime.ranges edges such as 25:00 are reported as errors, the old .tp-ui-ripple classes are gone, and some focus-ring and radius tokens changed. The CHANGELOG lists them under "Check before upgrading".
From 4.3 nothing breaks. 4.4 adds the blueprint and blueprint-dark themes, 16 new labels.* for screen-reader text, and Home/End/PageUp/PageDown keys. See the CHANGELOG.
From 3.x, options are now grouped (clock, ui, labels, ...), events go through picker.on(), and CSS class names changed. There's a migration guide.
From 2.x, you have to import the CSS yourself and some event names changed (legacy guide).
Frameworks
React:
import { useEffect, useRef } from "react";
import { TimepickerUI } from "timepicker-ui";
import "timepicker-ui/main.css";
function TimePicker() {
const ref = useRef<HTMLInputElement>(null);
useEffect(() => {
if (!ref.current) return;
const picker = new TimepickerUI(ref.current);
picker.create();
return () => picker.destroy();
}, []);
return <input ref={ref} />;
}
There's also a React wrapper (docs). Vue and Angular examples are in the quick start docs.
Need a date picker?
datepicker-ui is the companion calendar from the same author. It has no dependencies, follows Material Design 3, is safe to import during server rendering and uses the same theme names, so the two pickers match. It covers single dates, ranges and multiple dates.
npm install @pglejzer/datepicker-ui
The date and time guide shows how to use both pickers in one form.
Coming in 5.0
5.0.0 is planned but has no release date yet. 4.5.0 prepares for it. Planned changes:
- Plugins will be built and registered differently.
PluginRegistry.register(...)and the exported plugin types (PluginRegistry,Plugin,PluginManager,PluginFactory,TemplateProvider,ClearHandler,CoreState,EventEmitter) will change. The built-in range, timezone and wheel plugins stay. A migration guide ships with 5.0. - CSS class names keep the
tp-ui-prefix, but the part after it is reworked to follow Material Design component naming. Custom CSS that targets these classes will need updating. 5.0 ships a table of old and new names. - The options renamed in 4.5.0 lose their old names, for example
ui.mobile(nowui.initialView) andclock.smoothHourSnap(nowclock.discreteHourJump). The options page lists every pair. Theselect:am/select:pmevents go too (useselect:period), and so doesupdate()(usesetOptions()). behavior.returnFocusbecomestrueby default: on close, focus goes back to the input, or to thedata-openelement that opened the picker. Setbehavior.returnFocus: truenow to return focus to the input.- Code that is no longer needed is removed, including backward-compatibility paths for the deprecated items and dead code. This reduces bundle size and load cost for the core and each plugin. No size target is set yet. 4.5.0 already removes internal dead code that has no effect on the public API or markup. 5.0 removes the rest together with the items below.
- Items deprecated in 4.5.0 are removed:
OptionTypes(useTimepickerOptions)clock.currentTime.localesgetValue().degreesHoursandgetValue().degreesMinuteslabels.toggleLabel,labels.format24Label,labels.timezoneSelectorLabel- the legacy
focusInputAfterCloseModaloption (usebehavior.returnFocus) - the
hideevent andHideEventData(never emitted) - the
range:get-disabled-timeandrange:update-disabledevents (never emitted) ErrorEventData.rejectedHourandrejectedMinute(alwaysundefined)
- Also removed, because they do nothing or mislead:
- internal events in the public
TimepickerEventMap(range:minute:commit,animation:*) and its catch-all index signature, soon('typo')becomes a type error behavior.delayHandler(it only delays closing and never debounced buttons)TimepickerUI.isAvailable()(same asdocument.querySelector(...) !== null)- the undocumented DOM getters
hour,minutes,okButton,cancelButton,clockHand - the callback arguments of
open(cb)anddestroy()in both forms,destroy(cb)anddestroy({ callback })(useonce('open')or run the code after the call) RangeManager,TimezoneManagerandWheelManagerexported from the plugin entry points (you can't get an instance today, and the new plugin API replaces them)
- internal events in the public
- Changed events and options:
select:hour,select:minuteandselect:secondfire once when a value of their unit is picked, in every mode. Today, in clock mode, they fire when a field is activated, so picking an hour firesselect:minute. To follow face changes, useswitch:face, which 4.5.0 already emitsui.footerreplacesui.inline.showButtonsandwheel.hideFooter:falsehides OK, Cancel and Clear in every mode, andtrueshows them in inline mode toobehavior.commitOnChangereplacesui.inline.autoUpdateandwheel.commitOnScroll: each picked value is written to the input and emitsconfirm, and the picker stays openwheel.ignoreOutsideClickmoves tobehavior.ignoreOutsideClickand works in every mode, the clock modal included- the minute announcement reads
labels.minute;labels.announceMinuteis removed (its default is alreadyMinutesince 4.7.0) ui.cssClassis applied to one element instead of two
- Package and CSS:
- about 50 CSS custom properties that no rule reads are removed, for example
--tp-tertiary-container,--tp-on-tertiary-container,--tp-radius,--tp-hover-bgand 18 of the 34--tp-size-*tokens. 5.0 lists them all - the
./plugins/*wildcard inpackage.jsonexportsis removed, while./plugins/range,./plugins/timezoneand./plugins/wheelstay crane-straightbecomes a variant ofcranewith square corners (option name not decided)ui.keyboardIcon/ui.clockIcontake an element or a factory function instead of an HTML string
- about 50 CSS custom properties that no rule reads are removed, for example
Details are on the roadmap.
Development
See app/README.md.
Contributing
Issues and PRs welcome on GitHub.
License
MIT © Piotr Glejzer
timepicker-ui MCP questions
How do I add timepicker-ui MCP to Claude Code?
Run claude mcp add timepicker-ui -- npx -y timepicker-ui-mcp in your terminal. Add --scope user to make it available in every project.
How do I add timepicker-ui MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does timepicker-ui MCP provide?
It exposes 17 tools, including list_themes, list_modes, list_plugins, list_events, list_api.
Does it work with SSR frameworks like Next.js?
Yes, it is safe for SSR because it does not touch window or document on import.
Can I use it with React, Vue, or Angular?
Yes, it has a plain JS API that works with React, Vue, Angular, Svelte, or without a framework.
Does it support accessibility features?
Yes, it includes keyboard and screen reader support, and all text can be translated via labels.
Is it lightweight?
Yes, the core is approximately 29 KB gzipped and has zero dependencies.