MCP · Streamable HTTP
Timex MCP — अपने AI को अपने दिन से जोड़ें
Timex 1.3.0 से उपलब्ध।
यह क्या है
Timex Streamable HTTP पर एक लोकल MCP सर्वर चलाता है। यह डिफ़ॉल्ट रूप से बंद रहता है, जब तक आप बदलें नहीं तब तक 127.0.0.1:41741 से बँधा रहता है और bearer token से सुरक्षित है।
जो क्लाइंट stdio सर्वर शुरू करते हैं उनके लिए Timex.app में timex-mcp ब्रिज शामिल है। जुड़ने के बाद क्लाइंट Timex द्वारा दर्ज गतिविधि देख सकता है, जिसमें विंडो टाइटल और URLs शामिल हैं।
इसे चालू करें
- Settings ▸ Integrations खोलें।
- Enable MCP server चालू करें।
- Token कॉपी करें।
Host बदलने पर Timex चेतावनी देता है कि सर्वर आपके नेटवर्क से पहुँच योग्य हो सकता है। Bearer token फिर भी ज़रूरी है।
क्लाइंट जोड़ें
YOUR_TOKEN की जगह Timex का token डालें। कॉन्फ़िगरेशन बदलने के बाद क्लाइंट फिर शुरू करें।
Claude Code
Timex को remote Streamable HTTP सर्वर की तरह जोड़ें।
claude mcp add --transport http timex http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN"Claude Desktop
Settings ▸ Integrations में Add to Claude Desktop इस्तेमाल करें, या इसे ~/Library/Application Support/Claude/claude_desktop_config.json में जोड़ें।
{"mcpServers":{"timex":{"command":"/Applications/Timex.app/Contents/MacOS/timex-mcp"}}}ब्रिज Timex preferences से host, port और token पढ़ता है। TIMEX_MCP_URL और TIMEX_MCP_TOKEN इन मानों को बदल देते हैं। विकल्प के तौर पर, Node इंस्टॉल हो तो npx -y mcp-remote http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN" भी काम करता है।
Codex CLI (OpenAI)
Token export करके CLI command इस्तेमाल करें, या TOML entry को ~/.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
इस remote सर्वर को 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"}}}}Muvon का Octomind GitHub ↗
`headers` support वाले Octomind (मौजूदा master) के लिए यह HTTP सर्वर जोड़ें और जिन roles को इसे इस्तेमाल करना है, उनमें इसका reference दें।
[[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"Headers न भेज सकने वाले पुराने Octomind builds के लिए नीचे दिया fallback URL इस्तेमाल करें। Timex header-less clients के लिए ?token= स्वीकार करता है; इसे केवल loopback पर रखें।
Cursor
इसे ~/.cursor/mcp.json में सेव करें।
{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}Zed
इस सर्वर entry को Zed की MCP settings में जोड़ें।
{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}VS Code
इसे .vscode/mcp.json में सेव करें। VS Code, mcpServers की जगह servers key इस्तेमाल करता है।
{"servers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}16 टूल
get_summary तारीख़ की अवधि के लिए ट्रैक किए समय का सारांश।
list_activities तारीख़ की अवधि के गतिविधि रिकॉर्ड दिखाता है।
search_activities दर्ज apps, विंडो टाइटल और URLs में खोजता है।
get_current_activity अभी Timex क्या ट्रैक कर रहा है, यह दिखाता है।
list_categories श्रेणियाँ और उनके focus weights दिखाता है।
list_rules App, title और URL वर्गीकरण नियम दिखाता है।
add_rule वर्गीकरण नियम बनाता है।
remove_rule वर्गीकरण नियम हटाता है।
create_category Focus weight के साथ श्रेणी बनाता है।
update_category श्रेणी का नाम या weight बदलता है।
add_manual_entry अपने-आप ट्रैक न हुआ समय दर्ज करता है।
export_csv तारीख़ की अवधि को CSV फ़ाइल में निर्यात करता है।
pause_tracking अपने-आप गतिविधि ट्रैकिंग रोकता है।
resume_tracking अपने-आप गतिविधि ट्रैकिंग फिर चालू करता है।
start_break Timex में ब्रेक शुरू करता है।
list_backups Timex database के लोकल backups दिखाता है।
प्रोटोकॉल: Streamable HTTP; प्रोटोकॉल revisions 2026-07-28 / 2025-11-25 / 2025-06-18 / 2025-03-26; stateless (कोई session नहीं); header-less clients के लिए ?token= स्वीकार किया जाता है; Origin केवल localhost तक सीमित है।
उदाहरण प्रश्न
- “इस हफ़्ते Zoom में पिछले हफ़्ते के मुकाबले कितना समय गया?”
- “मंगलवार दोपहर 2 से 4 बजे के बीच मैं क्या कर रहा था?”
- “github.com को Development में गिनो”
- “आज दोपहर 3 बजे की 45 मिनट की क्लाइंट कॉल Communication में दर्ज करो”
- “इस महीने को CSV के रूप में ~/Desktop पर export करो”
समस्या निवारण
Timex चल नहीं रहा या उसका MCP सर्वर बंद है
Timex खोलें और Settings ▸ Integrations में सर्वर चालू करें।
401 Unauthorized
Token फिर बनाएँ या कॉपी करें, क्लाइंट config अपडेट करें और क्लाइंट फिर शुरू करें।
किसी दूसरे host से बँधा है
Token फिर भी ज़रूरी है और ?token= भी स्वीकार किया जाता है। Browser से Origin check केवल localhost origins को अनुमति देता है।