AI 에이전트를 Todoist와 연결하는 라이브러리입니다. LLM에 통합할 수 있는 도구를 포함합니다. 사용자를 대신해 Todoist 계정에 접근하고 수정할 수 있게 합니다.

이 도구들은 MCP 서버를 통해서도 사용할 수 있고, 다른 프로젝트에 직접 가져올 수도 있습니다. 이들을 여러분의 AI 대화 인터페이스에 통합하세요.

도구를 사용해

1. 이 저장소를 의존성으로 추가하세요

2. 도구를 불러와서 AI에 연결하세요

여기 Vercel의 AI SDK를 사용한 예시가 있습니다.

MCP 서버로 사용 중

퀵 스타트

NPX로 MCP 서버를 직접 실행할 수 있습니다:

설정 가이드

Todoist MCP 서버는 다양한 AI 클라이언트와의 통합을 위해 스트리밍 가능한 HTTP 서비스로 제공됩니다:

기본 URL (스트리밍 가능한 HTTP): https://ai.todoist.net/mcp

클로드 데스크탑

1. 커넥터 설정 → 열기 → 커스텀 커넥터 추가
2. https://ai.todoist.net/mcp를 입력하고 OAuth 인증을 완료합니다

커서

구성 파일 만들기:

• 글로벌: ~/.cursor/mcp.json
• 프로젝트 특화: .cursor/mcp.json

그런 다음 커서 설정에서 서버를 활성화하면 됩니다.

클로드 코드 (CLI)

가장 빠른 설정은 공식 Todoist 플러그인으로, MCP 서버를 연결해 줍니다:

Todoist MCP Server

Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs, enabling them to access and modify a Todoist account on the user’s behalf.

These tools can be used both through an MCP server, or imported directly in other projects to integrate them to your own AI conversational interfaces.

Using tools

1. Add this repository as a dependency

npm install @doist/todoist-mcp

2. Import the tools and plug them to an AI

Here’s an example using Vercel’s 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),
    },
})

Using as an MCP server

Quick Start

You can run the MCP server directly with npx:

npx @doist/todoist-mcp

Setup Guide

The Todoist MCP server is available as a streamable HTTP service for easy integration with various AI clients:

Primary URL (Streamable HTTP): https://ai.todoist.net/mcp

Claude Desktop

1. Open Settings → Connectors → Add custom connector
2. Enter https://ai.todoist.net/mcp and complete OAuth authentication

Cursor

Create a configuration file:

• Global: ~/.cursor/mcp.json
• Project-specific: .cursor/mcp.json

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

Then enable the server in Cursor settings if prompted.

Claude Code (CLI)

The fastest setup is the official Todoist plugin, which wires up the MCP server for you:

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

OAuth runs in your browser the first time you use a Todoist tool. See Anthropic’s plugin docs for more.

If you’d rather configure the MCP server manually, run:

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

Then launch claude, execute /mcp, and select the todoist MCP server to authenticate.

Visual Studio Code

1. Open Command Palette → MCP: Add Server
2. Select HTTP transport and use:

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

Other MCP Clients