मुख्य सामग्री पर जाएं

किसी एजेंट को अपनी to-do list चलाने दें

एक ऐसे todo MCP server की तलाश में हैं जो hosted database की बजाय असली फ़ाइलों पर काम करे? taskforge इसे एक subcommand के रूप में शामिल करता है, taskforge mcp --stdio, आपके Obsidian vault के लिए। Claude Desktop या किसी और MCP client को इसकी ओर इशारा करें, और एजेंट tools के एक छोटे सेट के ज़रिए कार्य जोड़ता है, खोजता है, एडिट करता है और पूरा करता है। यह आपकी मशीन पर चलता है और वही markdown फ़ाइलें एडिट करता है जो ऐप करता है। न कोई hosted server, न कोई API key।

TaskForge 3.0 में जल्द आ रहा है

TaskForge CLI और MCP सर्वर, TaskForge 3.0 रिलीज़ के साथ आएंगे। इस पेज पर बताया गया है कि लॉन्च के समय ये कैसे काम करेंगे। TaskForge ऐप आज ही उपलब्ध है।

MCP या CLI?

जब आपके एजेंट के पास पहले से TaskForge से MCP कनेक्शन हो, तो MCP tools को प्राथमिकता दें। ये टाइप्ड होते हैं, ऐसी structured errors लौटाते हैं जिनसे एजेंट खुद को ठीक कर सके, और आपके PATH में कुछ भी नहीं चाहिए। बिना MCP कनेक्शन वाले shell संदर्भों, जैसे scripts, cron, CI, या repo checkout में काम करने वाले coding एजेंट के लिए, इसकी बजाय CLI अपनाएं। दोनों एक ही engine को समान semantics के साथ चलाते हैं, इसलिए जो भी आपके runtime में पहले से जुड़ा है उसे चुनें। वॉल्ट फ़ाइलों को हाथ से बदलना आखिरी विकल्प है।

इंस्टॉल करें

अनुशंसित: npx

इसे अपने MCP क्लाइंट के config में जोड़ें। npx पहली बार चलने पर ही taskforge-md डाउनलोड कर लेता है, इसलिए पहले से कुछ भी इंस्टॉल करने की ज़रूरत नहीं।

Claude Desktop, एक क्लिक में

गाइडेड इंस्टॉल पसंद करते हैं? taskforge बंडल (.mcpb फ़ाइल) डाउनलोड करें और उसे खोलें। Claude Desktop आपको पूरी सेटअप प्रक्रिया से गुज़ारता है और आपका वॉल्ट फ़ोल्डर माँगता है।

लॉन्च पर उपलब्ध 
{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

npx की जगह taskforge को सोर्स से खुद बिल्ड किया? config को सीधे बाइनरी की ओर इशारा करें:

लॉन्च पर उपलब्ध 
"command": "taskforge",
"args": ["mcp", "--stdio"]

सिर्फ़ डेस्कटॉप के लिए, क्योंकि MCP क्लाइंट वहीं होते हैं। taskforge macOS, Windows और Linux के लिए एक ही नेटिव बाइनरी के रूप में उपलब्ध है, और MCP सर्वर उसके subcommands में से एक है।

पूरा tool सेट

कुल 22 tools हैं, जो पूरे task lifecycle को कवर करते हैं: create, read, update, complete, archive और delete, हर एक का एक bulk वर्ज़न भी; move, reparent, और inline line व TaskNotes फ़ाइल के बीच convert करना; लाइन लिखने से पहले एक lint जांच; vault की सेहत जांचने के लिए एक doctor कॉल; और schema व list resources, ताकि एजेंट काम करने से पहले आपका फ़ॉर्मैट सीख ले। नीचे दिए छह वे हैं जिनकी आपको सबसे ज़्यादा ज़रूरत पड़ेगी। हर कॉल वॉल्ट को डिस्क से फिर से पढ़ता है, इसलिए एजेंट हमेशा मौजूदा फ़ाइलों पर काम करता है।

query_tasks कार्यों को खोजें और फ़िल्टर करें, या कोई सेव की गई सूची पढ़ें। केवल पढ़ने के लिए। केवल पढ़ने के लिए
get_task एक कार्य और उसका कंटेंट हैश पढ़ें। केवल पढ़ने के लिए। केवल पढ़ने के लिए
add_task वॉल्ट के डिफ़ॉल्ट टार्गेट में, आपके फ़ॉर्मेट में एक कार्य बनाएं। लिखता है
update_task किसी कार्य की स्थिति, प्राथमिकता, नियत तारीख़, शीर्षक, या टैग बदलें। लिखता है
complete_task एक कार्य पूरा करें; अगर वह दोहराता है तो अगली घटना लौटाता है। लिखता है, idempotent नहीं
delete_task एक कार्य हटाएं। मॉडल को उसका ठीक मौजूदा शीर्षक वापस दोहराना ज़रूरी है, यह किसी पुराने या हैलुसिनेटेड id पर काम करने से बचाव करता है। विनाशकारी

अब हर tool में annotations होते हैं, ताकि किसी क्लाइंट को एक नज़र में पता चल जाए कि कौन सी कॉल सिर्फ़ पढ़ती हैं, कौन सी लिखती हैं, और कौन सी हटाती है। बाकी सेट में bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_task_lists और get_schema भी शामिल हैं।

तीन resources

tools के साथ-साथ, सर्वर read-only context भी उपलब्ध कराता है ताकि एजेंट काम करने से पहले आपके वॉल्ट के नियम सीख ले:

taskforge://schema मशीन-रीडेबल कार्य बोली: स्थिति चिह्न, तारीख़ फ़ॉर्मेट, कस्टम फ़ील्ड्स, राइट टार्गेट।
taskforge://agents-guide आपके वॉल्ट की कार्य परंपराओं की सादी भाषा में गाइड।
taskforge://lists आपकी सेव की गई कार्य सूचियाँ और हर एक में कार्य कैसे जोड़ें।

एक ज़रूरत: वॉल्ट कॉन्ट्रैक्ट

सर्वर वे कॉन्ट्रैक्ट फ़ाइलें पढ़ता है जो TaskForge आपके वॉल्ट में लिखता है, taskforge/schema.json और taskforge/agents.md, ताकि आपका सटीक कार्य फ़ॉर्मेट सीख सके। TaskForge 3.0 या उसके बाद के वर्शन में वॉल्ट को कम से कम एक बार खोलें, Settings, AI & Agents पर जाएं, और "Generate agent files" को चालू रहने दें। अगर वॉल्ट किसी हाल के बिल्ड में कभी नहीं खोला गया, तो सर्वर सामान्य डिफ़ॉल्ट पर वापस चला जाता है और क्लाइंट को चेतावनी देता है।

अगर इसे आपका वॉल्ट नहीं मिलता

सर्वर हमेशा शुरू होता है, यहाँ तक कि इससे पहले भी कि उसे पता हो कि आपका वॉल्ट कहाँ है, इसलिए Claude Desktop कभी कोई अस्पष्ट "server failed to start" नहीं दिखाता। जब कोई tool कॉल वॉल्ट को resolve नहीं कर पाती, तो यह एक सादी त्रुटि लौटाता है जिसे एजेंट आगे बता सके: TASKFORGE_VAULT एनवायरनमेंट वेरिएबल को अपने वॉल्ट पथ पर सेट करें, या बंडल दोबारा इंस्टॉल करें और पूछे जाने पर वॉल्ट डायरेक्टरी दर्ज करें।

सिर्फ़ लोकल

taskforge mcp --stdio सिर्फ़ आपके कॉन्फ़िगर किए गए वॉल्ट की markdown फ़ाइलें पढ़ता और लिखता है, और कुछ नहीं। न कोई अकाउंट, न कोई क्लाउड। आपका मौजूदा सिंक, iCloud, Dropbox, या Obsidian Sync, डिवाइसों के बीच बदलाव पहुँचाता है।

टर्मिनल पसंद है?

अगर आप अपने कार्यों को स्क्रिप्ट करना चाहते हैं या किसी एजेंट से चलवाने की बजाय एक-बार के कमांड चलाना चाहते हैं, तो taskforge CLI उसी वॉल्ट को उन्हीं नियमों के साथ संभालता है।

taskforge CLI इंस्टॉल करें →

लोग जो सवाल पूछते हैं

taskforge MCP server क्या है?

यह taskforge binary में बना एक local Model Context Protocol server है। इसे taskforge mcp --stdio से चलाएं, और Claude Desktop जैसा कोई MCP client 22 typed tools के ज़रिए, अकेले या bulk में, आपके Obsidian vault में कार्य जोड़, खोज, एडिट, मूव, पूरा और डिलीट कर सकता है। यह एक ऐसी to-do list है जिस पर आपका एजेंट काम कर सकता है, सिर्फ़ पढ़ नहीं सकता।

यह किन MCP clients के साथ काम करता है?

किसी भी client के साथ जो stdio पर MCP बोलता है। Claude Desktop सबसे आम है, और Claude Code, Cursor, तथा (GitHub Copilot के लिए) VS Code, सभी वही config लेते हैं। हर एक को वही 22 tools और तीन resources मिलते हैं।

क्या यह hosted या remote MCP server है?

नहीं। यह आपकी मशीन पर stdin और stdout के ज़रिए चलता है और सिर्फ़ उस vault फ़ोल्डर को छूता है जिसकी ओर आप इसे इशारा करते हैं। न कोई host करने के लिए URL, न कोई API key, न कोई TaskForge account। यही तो बात है: आपकी to-do list आपकी डिस्क पर ही रहती है।

क्या मुझे पहले से कुछ इंस्टॉल करना होगा?

पहले से नहीं। अपने client के config को npx -y taskforge-md mcp --stdio पर इशारा करें, और npx पहली बार चलने पर पैकेज डाउनलोड कर लेता है। Claude Desktop यूज़र्स इसकी बजाय गाइडेड इंस्टॉल के लिए .mcpb बंडल खोल सकते हैं।

client कहता है कि server को मेरा vault नहीं मिल रहा। अब क्या करें?

server हमेशा शुरू होता है, इसलिए client कभी कोई अस्पष्ट "failed to start" नहीं दिखाता। जब कोई tool कॉल vault को resolve नहीं कर पाती, तो यह एक सादा संदेश लौटाता है: TASKFORGE_VAULT एनवायरनमेंट वेरिएबल को अपने vault पथ पर सेट करें, या बंडल दोबारा इंस्टॉल करें और पूछे जाने पर vault directory दर्ज करें।

क्या इसे vault contract फ़ाइलों की ज़रूरत है?

हां, आपके फ़ॉर्मेट से मेल खाने के लिए। यह taskforge/schema.json और taskforge/agents.md पढ़ता है, जो "Generate agent files" चालू रखते हुए TaskForge 3.0 या उसके बाद के वर्शन में vault खोलने पर बनती हैं। इनके बिना भी यह चलता है, लेकिन सामान्य डिफ़ॉल्ट पर वापस चला जाता है और client को चेतावनी देता है कि यह अंदाज़ा लगा रहा है।

एजेंट लिस्ट पर काम करता है। ऐप उसे संभालता है।

MCP server आपके vault में लिखता है; TaskForge उन फ़ाइलों को आपकी सभी डिवाइसों पर lists, widgets और reminders में बदल देता है। iPhone, iPad, Mac और Android पर मुफ़्त डाउनलोड के लिए उपलब्ध।

Apple मुफ्त प्राप्त करें - iOS और Mac Android मुफ्त प्राप्त करें - Android