"इस हफ़्ते मैंने Zoom में कितना समय बिताया?"

आज यह जवाब देने के लिए आप tracker खोलते हैं, date picker ढूँढते हैं, filter लगाते हैं, app list पर आँखें सिकोड़ते हैं, मन में हिसाब लगाते हैं। 90 सेकंड का काम जो महीने में शायद दो बार होता है — इसीलिए ज़्यादातर लोग इसे कभी नहीं करते, और डेटा वहीं पड़ा अप्रयुक्त रहता है।

Timex 1.3.0 ने इसका दूसरा जवाब पेश किया: एक local MCP server। Settings → Integrations में चालू करें, अपना AI client connect करें, और सवाल सादी भाषा में पूछें। AI आपका time data query करके जवाब देता है — और डेटा आपके Mac से बाहर नहीं जाता।

छोटा जवाब: MCP (Model Context Protocol) AI assistants को local tools और डेटा पढ़ने और उन पर काम करने देता है। Timex का MCP server आपके tracking record पर 22 tools expose करता है — summaries, activity search, rules, entries, Energy, recovery, CSV export, focus sessions और breaks — ताकि Claude, Cursor या VS Code आपके समय के बारे में सवालों के जवाब दे सके और आपका setup manage कर सके। Default में off, localhost पर bind, और bearer token ज़रूरी।

MCP क्या है? एक पैराग्राफ़ में जवाब

Model Context Protocol वह standard है जो AI assistants को tools और डेटा use करने देता है, सिर्फ़ उनके बारे में बातें करने के बजाय। अपना हफ़्ता chat window में copy-paste करने के बजाय client एक बार connect करें, और वह functions call कर सकता है — summary पढ़ना, activity search, rule जोड़ना — वैसे ही जैसे वह पहले से आपकी files पढ़ता है या terminal चलाता है। Anthropic ने spec late 2024 में publish की, और अब major AI clients में supported है: Claude Desktop और Claude Code, Cursor, Zed, VS Code, Codex CLI, OpenCode, Octomind। इनमें से कोई भी use करते हैं तो client side आपके पास पहले से है।

Timex का server असल में क्या expose करता है

बाईस tools, काम के हिसाब से grouped:

Record पढ़ना: get_summary (एक range का tracked time, focus और Energy), list_activities (detailed rows, app या domain से filter), search_activities (titles, URLs, app names search), get_current_activity (अभी क्या live है)।

Setup manage करना: list_categories, list_rules, add_rule / remove_rule, create_category / update_category — वही rule engine जो UI use करती है, scriptable।

दिन पर काम करना: add_manual_entry (अभी हुई meeting log करें), log_recovery (एक away slot को Walk, Workout, Nap या Rest बताएँ), export_csv (summary या detailed, आपके home folder में लिखा जाता है), pause_tracking (चाहें तो तय मिनटों के लिए) / resume_tracking, start_break, list_backups। Timex 1.7.0 से start_focus_session / end_focus_session, snooze_break, pause_break_reminders और get_break_status भी।

दिलचस्प हिस्सा कोई single tool नहीं — compound queries हैं जो एक language model इनके पार बना सकता है।

Dashboard से बेहतर पाँच prompts

  • "इस हफ़्ते Zoom ने कितना लिया, और पिछले हफ़्ते से तुलना कैसी है?" — दो बार get_summary, एक comparison, और एक वाक्य जिस पर आप काम कर सकें। इसका dashboard version जवाब की क़ीमत से ज़्यादा लंबा चलता है।
  • "मंगलवार को 2 से 4 PM बीच मैंने क्या किया?" — एक window पर list_activities। "वो दोपहर कहाँ गया" का ईमानदार जवाब, window titles receipts की तरह।
  • "अब से github.com को focus गिनो।" — add_rule, हो गया, settings safari नहीं। यही वह है जो rules के use को बदलता है: आप उसी पल माँगते हैं जब ज़रूरत notice होती है, और rule-writing असल में सिर्फ़ उसी पल होती है।
  • "मैंने अभी 10:05 से 10:30 client call ख़त्म की — log करो।" — add_manual_entry। वो gap जो lunch तक भूल जाते, 10:31 पर log हो गया जब याद था।
  • "इस हफ़्ते को मेरे invoice के लिए summary CSV में export करो।" — export_csv। Invoice वाला दिन एक घंटे की archaeology से घटकर एक वाक्य रह गया।

1.5.0 ने क्या जोड़ा: Energy और recovery

Timex 1.5.0 (10 सितंबर) ने Energy जोड़ा — आज कितना demanding काम बचा है, इसका 0–100 estimate — और MCP server उसे expose करता है। get_summary अब tracked time के साथ Energy score, spent time, capacity, stretch fatigue, calls, passive time, recovery और debt minutes भी लौटाता है। एक नया log_recovery tool भी है — किसी away slot को Walk, Workout, Nap या Rest बताने के लिए।

दो और prompts जो सिर्फ़ 1.5.0 की वजह से काम करते हैं:

  • "आज मेरे पास कितना demanding काम बचा है?" — आज के लिए get_summary, Energy score और spent time पढ़ें। यह एक budget है, health measurement नहीं — वही caveat जो app दिखाता है।
  • "मैं 25 मिनट बाहर था — वह walk थी।" — log_recovery। वह away gap जो वरना unlabeled रहता, अब movement break गिना जाता है, और Energy update हो जाता है।

Security model, साफ़-साफ़

मैं इसे वैसे लिखूँगा जैसे मुझे लिखवाया जाना पसंद होता।

Server default में off है। Settings → Integrations में चालू करें, वहीं bind address और port चुनें, bearer token copy या regenerate करें। Default 127.0.0.1:41741 bind रखें तो server सिर्फ़ आपके Mac से reachable है — आपके network से नहीं, internet से नहीं।

Boundary असली है और मैं इसे blur नहीं करूँगा: connected client Timex जो कुछ record करता है वो सब पढ़ सकता है — window titles, URLs, app names — और आपके rules, categories, entries बदल सकता है। Token को password की तरह treat करें। Localhost से आगे bind किया तो वह access आपके network को expose हो गया।

Timex MCP protocol revisions 2026-07-28, 2025-11-25, 2025-06-18 और 2025-03-26 support करता है, और Settings हर client की configuration आपके current host, port, token और app path के साथ copy कर सकता है — Claude Desktop में MCP server जोड़ने के लिए one click, Claude Code, Cursor, Zed, VS Code, Codex CLI, OpenCode या Octomind के लिए copy-paste config।

Local-first और MCP क्यों साथ फिट बैठते हैं

इसकी एक philosophical वजह है कि यह local-first app में है, cloud वाली में नहीं। Cloud tracker "AI से अपने हफ़्ते के बारे में पूछो" को आपका हफ़्ता server पर भेजकर करता — उनका, या model का। MCP वाला रास्ता डेटा को आपकी machine पर रखता है और model को उसके पास आने देता है। आपका time record वहीं रहता है जहाँ record हुआ; intelligence visitor है, tenant नहीं।

यही ईमानदार limitation भी है: AI सिर्फ़ उतना जवाब दे सकता है जितना Timex ने record किया। वो आपका Mac देखता है, आपका फ़ोन या डेस्क से दूर की meetings नहीं — हाँ, manual entries उन gaps को भर देती हैं अगर log करें।

जब connect न हो

Server सिर्फ़ तब चलता है जब Timex चल रहा हो — app बंद करें और endpoint चला जाता है। Client को 401 मिले तो token ग़लत या पुराना है; Settings → Integrations में regenerate करें और नया paste करें। जो clients सिर्फ़ stdio बोलते हैं उन्हें app के साथ आने वाले timex-mcp bridge की ज़रूरत है; Settings सही command और path आपके लिए copy कर देता है। HTTP endpoint stateless है — खोने को कोई session नहीं — और जिस request का Origin localhost नहीं उसे reject कर देता है, इसलिए browser tab उस तक पहुँच नहीं सकता, कोशिश करे तो भी।

Dashboard 2010s का जवाब था "मैंने अपना समय कहाँ बिताया"। 2026 का जवाब उस model से बातचीत है जो record सच में पढ़ सकता है। Try करना है: Timex download करें, Settings → Integrations, switch चालू करें, और अपने हफ़्ते से एक सवाल पूछें। हर client की config Timex MCP setup गाइड में है।

— DK