intervals-mcp
intervals-mcp
Un servidor MCP independiente, CLI y plugin de Claude Code para el seguimiento de tiempo de Intervals con prioridad local. Iniciar un temporizador o registrar una entrada de tiempo escribe primero en una base de datos SQLite local; las entradas se sincronizan con Intervals en segundo plano o bajo demanda. Los informes y consultas son siempre solo locales y nunca llaman a la API de Intervals.
Instalación (plugin de Claude Code)
/plugin marketplace add sixfeetup/intervals-mcp
/plugin install intervals@intervals-mcpNo hay paso de compilación: el paquete dist/ está incluido en el repositorio. El único requisito es Node >= 22.5.
Related MCP server: Productivity Tracker MCP Server
Instalación (cualquier host MCP)
Clona el repositorio y apunta tu host MCP al servidor empaquetado:
git clone https://github.com/sixfeetup/intervals-mcp.git{
"command": "node",
"args": ["/path/to/intervals-mcp/dist/server.mjs"]
}Configuración
Las credenciales y ajustes se resuelven en este orden:
Variables de entorno
config.jsondentro deINTERVALS_HOME(o~/.intervals/)
Variables de entorno
Variable | Descripción |
| Clave de API de Intervals para autenticación básica HTTP |
| URL base de la API de Intervals (por defecto: |
| Tu ID de persona de Intervals (requerido para la sincronización de entradas de tiempo) |
| Sobrescribe la ruta de almacenamiento local predeterminada ( |
Claves de config.json
Si prefieres la configuración basada en archivos, crea config.json dentro de INTERVALS_HOME (o ~/.intervals/):
Clave | Tipo | Descripción |
|
| Clave de API de Intervals para autenticación básica HTTP |
|
| URL base de la API de Intervals (por defecto: |
|
| Tu ID de persona de Intervals (requerido para la sincronización de entradas de tiempo) |
|
| Intervalo de sincronización en segundo plano en milisegundos |
Ejecutar intervals setup (o el comando slash /intervals-setup) escribe este archivo con permisos 0600 y nunca coloca la clave de API en el contexto del modelo: la clave se introduce en un aviso interactivo oculto en tu propia terminal.
CLI
El paquete incluye una CLI sin dependencias (dist/cli.mjs, expuesta como intervals a través de package.json#bin cuando se instala como paquete):
Comando | Descripción |
| Configura las credenciales y ejecuta la sincronización inicial de proyectos |
| Muestra la ruta de la base de datos, la fuente de credenciales, los temporizadores y la sincronización pendiente |
| Actualiza el catálogo local de proyectos |
| Envía las entradas de tiempo pendientes a Intervals ahora |
| Muestra, edita o elimina temporizadores |
| Informa entradas de tiempo ( |
| Establece los valores predeterminados del proyecto |
Ejecuta node dist/cli.mjs help (o intervals help) para ver el texto de uso completo.
Herramientas del agente
Cuando se instala como plugin de Claude Code, las herramientas aparecen con el prefijo mcp__plugin_intervals_intervals__:
Herramienta | Descripción |
| Busca en el catálogo local de proyectos los IDs y clasificaciones (solo local) |
| Inicia un temporizador local con una descripción simple y un |
| Detiene un temporizador, resuelve la clasificación, crea una entrada de tiempo pendiente y sincroniza |
| Actualiza la descripción o las pistas de proyecto/tipo de trabajo/módulo en un temporizador local en ejecución |
| Elimina de forma segura un temporizador activo o detenido sin entrada de tiempo vinculada |
| Añade una entrada de tiempo completada directamente (duración en minutos) |
| Edita una entrada de tiempo local existente por ID corto o ID de temporizador vinculado; usa |
| Elimina una entrada de tiempo local o sincronizada por ID corto o ID de temporizador vinculado |
| Informa entradas de tiempo por rango de fechas y filtro de proyecto (solo local) |
| Lista temporizadores locales activos o recientes |
| Mapea un ID de temporizador local detenido al ID de entrada de tiempo local vinculado |
| Lista entradas de tiempo locales recientes con estado de sincronización |
| Configura el tipo de trabajo/módulo predeterminado para un proyecto |
| Reintenta inmediatamente la sincronización de entradas de tiempo pendientes con Intervals |
mcp__plugin_intervals_intervals__start_timer acepta valores opcionales de start_at para inicios retroactivos de temporizadores locales. Usa HH:mm o H:mm para hoy en hora local, YYYY-MM-DD HH:mm para una fecha/hora local, o una fecha ISO con desplazamiento/zona horaria explícita. Los valores futuros de start_at son rechazados.
Comandos slash
Comando | Descripción |
| Configura las credenciales de Intervals y ejecuta la sincronización inicial de proyectos |
| Muestra la ruta de la base de datos de Intervals, la fuente de credenciales, temporizadores activos, sincronización pendiente y última sincronización de proyectos |
| Actualiza el catálogo local de Intervals de clientes, proyectos, tipos de trabajo y módulos |
| Envía las entradas de tiempo locales pendientes a Intervals ahora |
| Muestra temporizadores de Intervals activos o recientes, o edita/elimina un temporizador por ID |
| Informa entradas de tiempo locales por rango, o edita una entrada por ID |
| Establece el tipo de trabajo predeterminado y el módulo opcional para un proyecto |
Cómo funciona
Los temporizadores son solo locales. Iniciar un temporizador escribe una fila local ligera con solo una descripción. Las pistas de proyecto, tipo de trabajo y módulo son opcionales.
Los temporizadores en ejecución pueden reclasificarse localmente. Edita las pistas de proyecto, tipo de trabajo o módulo de un temporizador antes de detenerlo; la clasificación actualizada se aplica cuando se crea la entrada de tiempo.
Detener/aplicar crea una entrada de tiempo. Cuando detienes un temporizador, proporcionas (o resuelves) el proyecto y el tipo de trabajo. El servidor crea una entrada de tiempo pendiente e intenta sincronizarla con Intervals inmediatamente.
Las entradas de tiempo son locales primero.
mcp__plugin_intervals_intervals__add_time,mcp__plugin_intervals_intervals__edit_timeymcp__plugin_intervals_intervals__stop_timerse guardan en SQLite antes de cualquier llamada de red. Si la sincronización falla, la entrada permanece local con estadofailedopendingy puede reintentarse.La sincronización del catálogo mantiene filas activas. La sincronización de proyectos obtiene todas las páginas del catálogo, mantiene proyectos activos y clasificaciones activas, y conserva los clientes referenciados por proyectos activos.
Los informes son solo locales.
mcp__plugin_intervals_intervals__query_timey/intervals-timeleen de SQLite y nunca llaman a la API de Intervals.
Nota para desarrolladores
Si abres este repositorio en Claude Code, es posible que veas el servidor MCP intervals listado como fallido al conectar. Eso es esperado: el .mcp.json en la raíz del repositorio es la configuración propia del plugin, y hace referencia a ${CLAUDE_PLUGIN_ROOT}, que solo se establece cuando el plugin se instala a través de /plugin install. Editar el código fuente de este repositorio no instala el plugin, por lo que la variable no está establecida y el servidor no puede iniciarse. Es seguro rechazar o ignorar cualquier aviso al respecto mientras trabajas en el código.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables recording, querying, and summarizing daily work entries with tags using a local SQLite database. Supports work logging, search, timeline queries, tag management, and automated reminders for tracking daily tasks.
- FlicenseNot gradedqualityDmaintenanceEnables natural language task management including logging, updating, and summarizing productivity activities across multiple categories using a local SQLite database. It allows users to manage workflows and generate time-based summaries through standardized Model Context Protocol tools.1
- AlicenseAqualityAmaintenanceEnables tracking work time with start/stop timers, logging entries, and generating reports.48MIT
- AlicenseNot gradedqualityBmaintenanceEnables multi-project workspaces to share structured notes, API contracts, and handoff messages via a local SQLite database, with versioning and read tracking.GPL 3.0
Related MCP Connectors
Track time on usetimebook.com - start/stop timers, log entries, list projects/clients.
Business-day, SLA, cron and recurrence calculations — offline, holiday-aware, no network.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sixfeetup/intervals-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server