MCP · Streamable HTTP

Timex MCP — conecta tu IA con tu día

Disponible a partir de Timex 1.3.0.

Qué es

Timex aloja un servidor MCP local mediante Streamable HTTP. Está desactivado por defecto, enlazado a 127.0.0.1:41741 salvo que lo cambies y protegido por un token bearer.

Para los clientes que inician servidores stdio, Timex.app incluye el puente timex-mcp. Una vez conectado, el cliente puede ver la actividad que registra Timex, incluidos los títulos de ventana y las URLs.

Activarlo

  1. Abre Ajustes ▸ Integraciones.
  2. Activa Habilitar servidor MCP.
  3. Copia el token.

Si cambias el host, Timex avisa de que el servidor puede quedar accesible desde tu red. El token bearer sigue siendo obligatorio.

Conectar un cliente

Sustituye YOUR_TOKEN por el token de Timex. Reinicia el cliente después de cambiar su configuración.

Claude Code

Añade Timex como servidor remoto Streamable HTTP.

claude mcp add --transport http timex http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop

Usa Añadir a Claude Desktop en Ajustes ▸ Integraciones, o añade esto a ~/Library/Application Support/Claude/claude_desktop_config.json.

{"mcpServers":{"timex":{"command":"/Applications/Timex.app/Contents/MacOS/timex-mcp"}}}

El puente lee el host, el puerto y el token de las preferencias de Timex. TIMEX_MCP_URL y TIMEX_MCP_TOKEN los sustituyen. Como alternativa, npx -y mcp-remote http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN" funciona si Node está instalado.

Codex CLI (OpenAI)

Exporta el token y usa el comando CLI, o añade la entrada TOML a ~/.codex/config.toml.

export TIMEX_MCP_TOKEN=YOUR_TOKEN
codex mcp add timex --url http://127.0.0.1:41741/mcp --bearer-token-env-var TIMEX_MCP_TOKEN
[mcp_servers.timex]
url = "http://127.0.0.1:41741/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

OpenCode

Añade este servidor remoto a opencode.json.

{"$schema":"https://opencode.ai/config.json","mcp":{"timex":{"type":"remote","url":"http://127.0.0.1:41741/mcp","enabled":true,"headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

Octomind de Muvon GitHub ↗

Para Octomind con compatibilidad con `headers` (master actual), añade este servidor HTTP y referéncialo desde los roles que deban usarlo.

[[mcp.servers]]
name = "timex"
type = "http"
url = "http://127.0.0.1:41741/mcp"
headers = { Authorization = "Bearer YOUR_TOKEN" }
timeout_seconds = 30

# then add "timex" to server_refs of the roles that should use it:
# [roles.mcp]
# server_refs = ["core", "timex"]
url = "http://127.0.0.1:41741/mcp?token=YOUR_TOKEN"

Para versiones anteriores de Octomind que no pueden enviar cabeceras, usa la URL alternativa que aparece debajo. Timex acepta ?token= para clientes sin cabeceras; úsalo solo en loopback.

Cursor

Guárdalo en ~/.cursor/mcp.json.

{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

Zed

Añade esta entrada de servidor a los ajustes MCP de Zed.

{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

VS Code

Guárdalo en .vscode/mcp.json. VS Code usa la clave servers en lugar de mcpServers.

{"servers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}

Las 16 herramientas

get_summary

Resume el tiempo registrado en un intervalo de fechas.

list_activities

Lista los registros de actividad de un intervalo.

search_activities

Busca en apps, títulos de ventana y URLs registrados.

get_current_activity

Muestra qué está registrando Timex ahora mismo.

list_categories

Lista las categorías y sus pesos de enfoque.

list_rules

Lista las reglas por app, título y URL.

add_rule

Crea una regla de categorización.

remove_rule

Elimina una regla de categorización.

create_category

Crea una categoría con un peso de enfoque.

update_category

Renombra una categoría o cambia su peso.

add_manual_entry

Registra tiempo que no se capturó automáticamente.

export_csv

Exporta un intervalo de fechas a un archivo CSV.

pause_tracking

Pausa el seguimiento automático de actividad.

resume_tracking

Reanuda el seguimiento automático de actividad.

start_break

Inicia un descanso en Timex.

list_backups

Lista las copias locales de la base de datos de Timex.

Protocolo: Streamable HTTP; revisiones del protocolo 2026-07-28 / 2025-11-25 / 2025-06-18 / 2025-03-26; sin estado (sin sesiones); se acepta ?token= para clientes sin cabeceras; Origin está restringido a localhost.

Ejemplos de preguntas

  • “¿Cuánto tiempo pasé en Zoom esta semana frente a la anterior?”
  • “¿Qué estaba haciendo el martes entre las 14:00 y las 16:00?”
  • “Haz que github.com cuente como Desarrollo”
  • “Registra una llamada con un cliente de 45 minutos hoy a las 15:00 en Comunicación”
  • “Exporta este mes como CSV a ~/Desktop”

Solución de problemas

Timex no está abierto o su servidor MCP está desactivado

Abre Timex y activa el servidor en Ajustes ▸ Integraciones.

401 No autorizado

Regenera o vuelve a copiar el token, actualiza la configuración y reinicia el cliente.

Enlazado a otro host

El token sigue siendo obligatorio y ?token= sigue siendo válido. Desde navegadores, la comprobación Origin solo permite orígenes localhost.