Todoist MCP

Todoist MCP Sunucusu

AI ajanlarını Todoist'e bağlamak için kütüphane. LLM'lere entegre edilebilen, kullanıcı adına bir Todoist hesabına erişmelerini ve değiştirmelerini sağlayan araçlar içerir.

Bu araçlar hem bir MCP sunucusu aracılığıyla kullanılabilir hem de kendi AI konuşma arayüzlerinize entegre etmek için doğrudan diğer projelere aktarılabilir.

Araçları Kullanma

1. Bu depoyu bağımlılık olarak ekleyin

npm install @doist/todoist-mcp

2. Araçları içe aktarın ve bir AI'ya bağlayın

İşte Vercel'in AI SDK'sını kullanan bir örnek.

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 Sunucusu Olarak Kullanma

Hızlı Başlangıç

MCP sunucusunu doğrudan npx ile çalıştırabilirsiniz:

npx @doist/todoist-mcp

Kurulum Rehberi

Todoist MCP sunucusu, çeşitli AI istemcileriyle kolay entegrasyon için akışkan bir HTTP hizmeti olarak sunulmaktadır:

Birincil URL (Akışkan HTTP): https://ai.todoist.net/mcp

Claude Desktop

1. Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle'yi açın
2. https://ai.todoist.net/mcp girin ve OAuth kimlik doğrulamasını tamamlayın

Cursor

Bir yapılandırma dosyası oluşturun:

• Genel: ~/.cursor/mcp.json
• Projeye özel: .cursor/mcp.json

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

Ardından istendiğinde Cursor ayarlarında sunucuyu etkinleştirin.

Claude Code (CLI)

En hızlı kurulum, MCP sunucusunu sizin için bağlayan resmi Todoist eklentisidir:

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

OAuth, bir Todoist aracını ilk kullandığınızda tarayıcınızda çalışır. Daha fazlası için Anthropic'in eklenti belgelerine bakın.

MCP sunucusunu manuel olarak yapılandırmayı tercih ederseniz, şunu çalıştırın:

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

Ardından claude başlatın, /mcp çalıştırın ve kimlik doğrulamak için todoist MCP sunucusunu seçin.

Visual Studio Code

1. Komut Paleti → MCP: Sunucu Ekle'yi açın
2. HTTP taşımasını seçin ve şunu kullanın:

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

Diğer MCP İstemcileri

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

MCP sunucusunu kurma ve kullanma hakkında daha fazla ayrıntı için, özel sunucular oluşturma dahil, docs/mcp-server.md dosyasına bakın.

Özellikler

Bu projenin önemli bir özelliği, araçların yeniden kullanılabilir olması ve yalnızca bir MCP sunucusunda kullanılmak üzere yazılmamış olmasıdır. Diğer konuşmaya dayalı AI arayüzlerine (ör. Vercel'in AI SDK'sı) araç olarak bağlanabilirler.

Bu proje erken aşamadadır. Yakında daha fazla ve/veya daha iyi araçlar bekleyin.

Yine de amacımız, yalnızca atomik eylemler yerine eksiksiz iş akışlarını etkinleştiren küçük bir araç seti sağlamak ve LLM'ler için esneklik ile verimlilik arasında bir denge kurmaktır.

Tasarım felsefemiz, yönergelerimiz ve geliştirme kalıplarımız için docs/tool-design.md dosyasına bakın.

Mevcut Araçlar

Mevcut araçların tam listesi için src/tools dizinine bakın.

OpenAI MCP Uyumluluğu

Bu sunucu, OpenAI MCP spesifikasyonunu takip eden search ve fetch araçlarını içerir ve OpenAI'nin MCP protokolüyle sorunsuz entegrasyon sağlar. Bu araçlar, daha geniş MCP ekosistemiyle uyumluluğu korurken OpenAI'nin gereksinimleri için optimize edilmiş JSON kodlu sonuçlar döndürür.

Bağımlılıklar

• Resmi @modelcontextprotocol/server kullanan MCP sunucusu
• Todoist Typescript API istemcisi @doist/todoist-sdk

MCP Sunucusu Kurulumu

MCP sunucusunu kurma hakkında tam talimatlar için docs/mcp-server.md dosyasına bakın.

Yerel Geliştirme Kurulumu

Tam kurulum talimatları için docs/dev-setup.md ve katkıda bulunan iş akışları ve kalite kontrolleri için CONTRIBUTING.md dosyasına bakın.

MCP Uygulamaları

Bu proje, AI sohbet arayüzlerinde satır içi işlenen etkileşimli UI widget'ları olan MCP Uygulamaları desteğini içerir. Widget'lar, düz metin yerine araç çıktılarının (ör. görev listeleri) zengin görsel temsillerini sağlar.

Widget mimarisi, derleme hattı ve geliştirme iş akışı için docs/mcp-apps.md dosyasına bakın.

Hızlı Başlangıç

Depoyu klonlayıp kurduktan sonra:

• npm start - Test için MCP denetçisini derleyin ve çalıştırın
• npm run dev - Otomatik yeniden derleme ve yeniden başlatma ile geliştirme modu
• npm run tool:list - Doğrudan yürütme için mevcut araçları listeleyin
• npm run tool -- <tool-name> '<json-args>' - MCP olmadan bir aracı doğrudan çalıştırın

npm run tool kullanırken, npm'nin bunları scripts/run-tool.ts öğesine iletmesi için araç bağımsız değişkenlerinden önce -- ekleyin.

Yazma işlemlerinden önce kontrol örneği: npm run tool -- user-info '{}' Bu, geçerli TODOIST_API_KEY öğesinin hangi Todoist hesabına bağlı olduğunu doğrular.

run-tool, .env dosyanızdaki TODOIST_API_KEY kullanır (.env.example tarafından npm run setup ile oluşturulur). Gerçek verileri değiştirmekten kaçınmak için yazma işlemlerini çalıştırırken bir test hesabı veya geçici bir proje kullanın.

Katkıda Bulunma

CONTRIBUTING.md dosyasına bakın:

• Geliştirme iş akışı
• Araçları doğrudan scripts/run-tool.ts ile çalıştırma
• Test ve kalite kontrolleri
• Commit kuralları

Yayınlama

Bu proje, sürüm yönetimini ve paket yayınlamayı otomatikleştirmek için release-please kullanır.

Nasıl çalışır

1. Conventional Commits kullanarak değişikliklerinizi yapın:

   • Yeni özellikler için feat: (minor sürüm artışı)
   • Hata düzeltmeleri için fix: (patch sürüm artışı)
   • Kırıcı değişiklikler için feat!: veya fix!: (major sürüm artışı)
   • Dokümantasyon değişiklikleri için docs:
   • Bakım görevleri için chore:
   • CI değişiklikleri için ci:

2. Commit'ler main dalına gönderildiğinde:

   • Release-please otomatik olarak bir yayın PR'si oluşturur/günceller
   • PR, sürüm artışı ve değişiklik günlüğü güncellemelerini içerir
   • PR'yi inceleyin ve hazır olduğunda birleştirin

3. Yayın PR'sini birleştirdikten sonra:

   • Otomatik olarak yeni bir GitHub sürümü oluşturulur
   • Yeni bir etiket oluşturulur
   • publish iş akışı tetiklenir
   • Paket npm'de yayınlanır