mstodo-bridge

Claude에서 Microsoft To Do를 직접 관리하세요. 구성이 필요 없는 MCP 서버로, 로그인도 대화 안에서 완료됩니다.

설치

1. Claude Code에 설치

claude mcp add -s user taskbridge -- npx -y mstodo-bridge

-s user는 전역 적용(모든 프로젝트에서 사용 가능)을 의미합니다. 완료 후 Claude Code 세션을 다시 시작하세요.

2. 또는 MCP 설정 파일에 작성

Claude Desktop: 설정 파일을 편집하세요(Windows %APPDATA%\Claude\claude_desktop_config.json, macOS ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "taskbridge": {
      "command": "npx",
      "args": ["-y", "mstodo-bridge"]
    }
  }
}

Cursor / 기타 MCP 클라이언트: 마찬가지로 npx -y mstodo-bridge를 stdio 명령으로 추가하세요. 저장 후 클라이언트를 다시 시작하세요.

3. 또는 웹 서비스 실행

특정 클라이언트에 종속되지 않고, 관리 콘솔이 포함된 서비스로 독립 실행할 수도 있습니다:

npx mstodo-bridge --http        # 管理台 http://127.0.0.1:46377/admin

최초 실행 시 관리 비밀번호와 MCP Bearer 토큰을 출력합니다(한 번만 표시). 다른 클라이언트는 http://<host>:46377/mcp(Bearer 인증)로 원격 접속할 수 있습니다. 서버/Hugging Face Spaces 배포는 아래 '배포'를 참조하세요.

Related MCP server: Remote MCP Entra ID Todo

로그인

방법 1: Claude에서(권장)

클라이언트를 다시 시작한 후 Claude에게 직접 말하세요:

Microsoft To Do에 연결해 줘

Claude가 login 도구를 호출하여 인증 링크를 제공합니다. → 브라우저에서 열기 → Microsoft 개인 계정으로 동의 → 자동으로 다시 연결되어 완료됩니다. 이후에는 자연어로 조작할 수 있습니다:

내 목록 보기 · X를 '연구 학술'에 추가, 금요일 마감 · '논문' 포함 작업 검색 · 3번째 항목 완료

방법 2: 웹 관리 콘솔을 통해

npx mstodo-bridge --http --open

1. 브라우저에서 관리 콘솔을 열고 시작 시 출력된 관리 비밀번호를 입력하여 로그인합니다.

2. Microsoft To Do 카드에서 '계정 연결'을 클릭하면, 브라우저에서 인증을 완료한 후 자동으로 돌아옵니다.

3. 원격 환경(브라우저와 서버가 다른 컴퓨터에 있는 경우)에서는 인증 후 localhost로 이동하며 오류가 발생합니다. 이는 예상된 동작입니다. 주소창의 전체 URL을 카드의 '연결 완료' 입력란에 붙여넣으면 됩니다.

두 방식으로 생성되는 자격 증명은 완전히 동일합니다(~/.mstodo-bridge). 어떤 방식이든 섞어 사용해도 됩니다.

MCP 도구(15개)

계정 및 로그인

목록

작업 읽기

작업 쓰기

provider?로 표시된 매개변수는 단일 계정 모드에서 생략할 수 있습니다.

배포

PORT=7860 HOST=0.0.0.0 PUBLIC_BASE_URL=https://<user>-<space>.hf.space npx mstodo-bridge --http

보안

자격 증명은 로컬에만 저장됩니다(~/.mstodo-bridge, 0600 권한). 비밀번호와 토큰은 scrypt 해시로만 저장되며 일정 시간 비교를 사용합니다. OAuth는 전체 과정에 PKCE + 일회용 state를 사용합니다. 관리 콘솔은 엄격한 CSP와 로그인 속도 제한을 적용합니다. 갱신 토큰이 만료되면 자동으로 삭제하고 재연결을 안내합니다.

개발

git clone https://github.com/WNJXYK/MSTodo-Bridge && cd MSTodo-Bridge
npm install && npm run build && npm test

Issue와 PR은 GitHub로 제출해 주세요.

License

MIT