Todoist MCP

आधिकारिक

अपने Todoist कार्यों और परियोजनाओं को सीधे अपने LLM से प्रबंधित करें।

GitHub

541

इस MCP को आज़माएँप्रायोजित

Todoist MCP के साथ आप क्या कर सकते हैं?

दिनांक के अनुसार कार्य खोजें — अपने सहायक से किसी विशिष्ट दिन के लिए निर्धारित कार्यों को findTasksByDate का उपयोग करके खोजने के लिए कहें।
नए कार्य जोड़ें — अपने सहायक से addTasks टूल के माध्यम से आपके लिए एक या अधिक Todoist कार्य बनवाएं।
खाता पहचान जांचें — कोई भी बदलाव करने से पहले पूछें कि कौन सा Todoist खाता कनेक्टेड है, सक्रिय उपयोगकर्ता की पुष्टि के लिए user-info का उपयोग करें।
टूल सीधे चलाएं — JSON तर्कों के साथ किसी भी टूल को स्टैंडअलोन रूप से निष्पादित करने के लिए npm run tool का उपयोग करें, जिससे MCP सर्वर को बायपास किया जा सके।

दस्तावेज़

Todoist MCP सर्वर

AI एजेंटों को Todoist से जोड़ने के लिए लाइब्रेरी। इसमें ऐसे टूल शामिल हैं जिन्हें LLM में एकीकृत किया जा सकता है, जिससे वे उपयोगकर्ता की ओर से Todoist खाते तक पहुँच सकें और उसमें संशोधन कर सकें।

इन टूल्स का उपयोग MCP सर्वर के माध्यम से किया जा सकता है, या सीधे अन्य प्रोजेक्ट्स में आयात करके उन्हें अपने स्वयं के AI संवादात्मक इंटरफेस में एकीकृत किया जा सकता है।

टूल्स का उपयोग

1. इस रिपॉजिटरी को निर्भरता के रूप में जोड़ें

npm install @doist/todoist-mcp

2. टूल्स को आयात करें और उन्हें AI से जोड़ें

यहाँ Vercel के AI SDK का उपयोग करने का एक उदाहरण है।

import { findTasksByDate, addTasks } from '@doist/todoist-mcp'
import { TodoistApi } from '@doist/todoist-sdk'
import { streamText } from 'ai'

// Create Todoist API client
const client = new TodoistApi(process.env.TODOIST_API_KEY)

// Helper to wrap tools with the client
function wrapTool(tool, todoistClient) {
    return {
        ...tool,
        execute(args) {
            return tool.execute(args, todoistClient)
        },
    }
}

const result = streamText({
    model: yourModel,
    system: 'You are a helpful Todoist assistant',
    tools: {
        findTasksByDate: wrapTool(findTasksByDate, client),
        addTasks: wrapTool(addTasks, client),
    },
})

MCP सर्वर के रूप में उपयोग

त्वरित प्रारंभ

आप MCP सर्वर को सीधे npx के साथ चला सकते हैं:

npx @doist/todoist-mcp

सेटअप गाइड

Todoist MCP सर्वर विभिन्न AI क्लाइंट्स के साथ आसान एकीकरण के लिए स्ट्रीमेबल HTTP सेवा के रूप में उपलब्ध है:

प्राथमिक URL (स्ट्रीमेबल HTTP): https://ai.todoist.net/mcp

Claude Desktop

सेटिंग्स → कनेक्टर्स → कस्टम कनेक्टर जोड़ें खोलें
https://ai.todoist.net/mcp दर्ज करें और OAuth प्रमाणीकरण पूरा करें

Cursor

एक कॉन्फ़िगरेशन फ़ाइल बनाएं:

वैश्विक: ~/.cursor/mcp.json
प्रोजेक्ट-विशिष्ट: .cursor/mcp.json

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
        }
    }
}

फिर संकेत मिलने पर Cursor सेटिंग्स में सर्वर सक्षम करें।

Claude Code (CLI)

सबसे तेज़ सेटअप आधिकारिक Todoist प्लगइन है, जो आपके लिए MCP सर्वर को जोड़ता है:

/plugin marketplace add doist/todoist-mcp
/plugin install todoist@doist

पहली बार जब आप Todoist टूल का उपयोग करते हैं तो OAuth आपके ब्राउज़र में चलता है। अधिक जानकारी के लिए Anthropic के प्लगइन दस्तावेज़ देखें।

यदि आप MCP सर्वर को मैन्युअल रूप से कॉन्फ़िगर करना चाहते हैं, तो चलाएँ:

claude mcp add --transport http todoist https://ai.todoist.net/mcp

फिर claude लॉन्च करें, /mcp निष्पादित करें, और प्रमाणीकरण के लिए todoist MCP सर्वर चुनें।

Visual Studio Code

कमांड पैलेट खोलें → MCP: सर्वर जोड़ें
HTTP ट्रांसपोर्ट चुनें और उपयोग करें:

{
    "servers": {
        "todoist": {
            "type": "http",
            "url": "https://ai.todoist.net/mcp"
        }
    }
}

अन्य MCP क्लाइंट्स

npx -y mcp-remote https://ai.todoist.net/mcp

MCP सर्वर की स्थापना और उपयोग के बारे में अधिक विवरण के लिए, जिसमें कस्टम सर्वर बनाना शामिल है, docs/mcp-server.md देखें।

विशेषताएँ

इस प्रोजेक्ट की एक प्रमुख विशेषता यह है कि टूल्स का पुनः उपयोग किया जा सकता है, और वे विशेष रूप से MCP सर्वर में उपयोग के लिए नहीं लिखे गए हैं। उन्हें अन्य संवादात्मक AI इंटरफेस (जैसे Vercel के AI SDK) में टूल्स के रूप में जोड़ा जा सकता है।

यह प्रोजेक्ट अपने प्रारंभिक चरण में है। जल्द ही अधिक और/या बेहतर टूल्स की उम्मीद करें।

फिर भी, हमारा लक्ष्य टूल्स का एक छोटा सेट प्रदान करना है जो केवल परमाणु क्रियाओं के बजाय पूर्ण वर्कफ़्लो सक्षम करें, जो LLM के लिए लचीलेपन और दक्षता के बीच संतुलन बनाता है।

हमारे डिज़ाइन दर्शन, दिशानिर्देशों और विकास पैटर्न के लिए, docs/tool-design.md देखें।

उपलब्ध टूल्स

उपलब्ध टूल्स की पूरी सूची के लिए, src/tools निर्देशिका देखें।

OpenAI MCP संगतता

इस सर्वर में search और fetch टूल्स शामिल हैं जो OpenAI MCP विनिर्देश का पालन करते हैं, जो OpenAI के MCP प्रोटोकॉल के साथ सहज एकीकरण सक्षम करते हैं। ये टूल्स OpenAI की आवश्यकताओं के लिए अनुकूलित JSON-एन्कोडेड परिणाम लौटाते हैं, साथ ही व्यापक MCP पारिस्थितिकी तंत्र के साथ संगतता बनाए रखते हैं।

निर्भरताएँ

आधिकारिक @modelcontextprotocol/server का उपयोग करने वाला MCP सर्वर
Todoist Typescript API क्लाइंट @doist/todoist-sdk

MCP सर्वर सेटअप

MCP सर्वर की स्थापना के पूर्ण निर्देशों के लिए docs/mcp-server.md देखें।

स्थानीय विकास सेटअप

पूर्ण सेटअप निर्देशों के लिए docs/dev-setup.md और योगदानकर्ता वर्कफ़्लो और गुणवत्ता जाँच के लिए CONTRIBUTING.md देखें।

MCP ऐप्स

इस प्रोजेक्ट में MCP ऐप्स के लिए समर्थन शामिल है – AI चैट इंटरफेस में इनलाइन प्रस्तुत किए जाने वाले इंटरैक्टिव UI विजेट्स। विजेट्स सादे टेक्स्ट के बजाय टूल आउटपुट (जैसे, कार्य सूचियाँ) के समृद्ध दृश्य प्रतिनिधित्व प्रदान करते हैं।

विजेट आर्किटेक्चर, बिल्ड पाइपलाइन और विकास वर्कफ़्लो के लिए docs/mcp-apps.md देखें।

त्वरित प्रारंभ

रिपॉजिटरी को क्लोन और सेटअप करने के बाद:

npm start - परीक्षण के लिए MCP इंस्पेक्टर बनाएं और चलाएं
npm run dev - ऑटो-रीबिल्ड और पुनरारंभ के साथ विकास मोड
npm run tool:list - सीधे निष्पादन के लिए उपलब्ध टूल्स की सूची बनाएं
npm run tool -- <tool-name> '<json-args>' - MCP के बिना सीधे टूल चलाएं

npm run tool का उपयोग करते समय, टूल तर्कों से पहले -- शामिल करें ताकि npm उन्हें scripts/run-tool.ts पर अग्रेषित कर सके।

लिखने के संचालन से पहले जाँच का उदाहरण: npm run tool -- user-info '{}' यह पुष्टि करता है कि वर्तमान TODOIST_API_KEY किस Todoist खाते से जुड़ा है।

run-tool आपकी .env फ़ाइल से TODOIST_API_KEY का उपयोग करता है (जो npm run setup द्वारा .env.example से बनाई गई है)। वास्तविक डेटा को संशोधित करने से बचने के लिए लिखने के संचालन चलाते समय परीक्षण खाते या अस्थायी प्रोजेक्ट का उपयोग करें।

योगदान

CONTRIBUTING.md देखें:

विकास वर्कफ़्लो
scripts/run-tool.ts के साथ सीधे टूल्स चलाना
परीक्षण और गुणवत्ता जाँच
कमिट परंपराएँ

रिलीज़

यह प्रोजेक्ट संस्करण प्रबंधन और पैकेज प्रकाशन को स्वचालित करने के लिए release-please का उपयोग करता है।

यह कैसे काम करता है

Conventional Commits का उपयोग करके अपने परिवर्तन करें:
- नई सुविधाओं के लिए feat: (मामूली संस्करण वृद्धि)
- बग फिक्स के लिए fix: (पैच संस्करण वृद्धि)
- ब्रेकिंग परिवर्तनों के लिए feat!: या fix!: (प्रमुख संस्करण वृद्धि)
- दस्तावेज़ीकरण परिवर्तनों के लिए docs:
- रखरखाव कार्यों के लिए chore:
- CI परिवर्तनों के लिए ci:
जब कमिट main पर पुश किए जाते हैं:
- Release-please स्वचालित रूप से एक रिलीज़ PR बनाता/अपडेट करता है
- PR में संस्करण वृद्धि और चेंजलॉग अपडेट शामिल होते हैं
- PR की समीक्षा करें और तैयार होने पर मर्ज करें
रिलीज़ PR को मर्ज करने के बाद:
- एक नई GitHub रिलीज़ स्वचालित रूप से बनाई जाती है
- एक नया टैग बनाया जाता है
- publish वर्कफ़्लो ट्रिगर होता है
- पैकेज npm पर प्रकाशित होता है