Todo4Agent

에이전트를 위해 설계된 MCP 작업 목록입니다. 에이전트는 MCP를 통해 당신의 작업을 직접 관리할 수 있고, 인터페이스에서도 수동으로 유지보수할 수 있습니다.

기능

• 작업 그룹 및 작업 관리: 생성, 편집, 완료, 마감 시각, 정렬

• 휴지통: 잘못 삭제해도 복구 가능

• 다중 사용자: 각 사용자의 작업 데이터가 서로 독립적

• JSON 가져오기/내보내기로 백업과 마이그레이션 편리

• 데스크톱 앱(Windows / macOS / Linux) 및 브라우저 WebUI(기본값 http://127.0.0.1:3000)

• WebUI는 기본적으로 0.0.0.0에서 수신 대기하므로 LAN 내 다른 기기에서 바로 접속할 수 있습니다. 「설정 → 서비스」에서 외부 접근을 차단(로컬 전용)하거나 포트를 변경할 수 있습니다

• 신규 사용자 등록은 기본적으로 활성화되어 있으며, 「설정 → 사용자」에서 끌 수 있습니다

• MCP 서비스: Agent가 표준 MCP 프로토콜로 작업 목록을 직접 조작

Related MCP server: TickTick MCP Server

설치

GitHub Releases에서 해당 플랫폼의 설치 패키지를 다운로드하면 됩니다. 서비스 포트와 외부 수신은 「설정 → 서비스」에서 변경할 수 있습니다(기본값 3000 / 0.0.0.0 수신).

처음 사용하기

시스템에 초기 계정이 기본으로 포함되어 있습니다.

• 사용자 이름: admin

• 비밀번호: admin123

로그인 후에는 가능한 한 빨리 「설정 → 사용자」에서 비밀번호를 변경하세요. 직접 새 계정을 등록할 수도 있습니다(등록 버튼은 기본적으로 활성화되어 있습니다).

Agent 연결(MCP)

MCP를 지원하는 Agent 클라이언트에서 다음과 같이 구성합니다.

{
  "mcpServers": {
    "todo4agent": {
      "command": "todo4agent",
      "args": ["mcp"],
      "env": {
        "TODO4AGENT_USERNAME": "你的用户名",
        "TODO4AGENT_PASSWORD": "你的密码"
      }
    }
  }
}

이제 Agent가 당신의 작업 목록에 대해 추가·삭제·조회·수정, 재정렬, 가져오기/내보내기 등을 수행할 수 있습니다. 소프트웨어 화면의 「Agent 연결」 페이지에서 클라이언트 구성을 한 번에 복사할 수 있습니다. 사용 가능한 도구:

자격 증명 설명: MCP 시작 시 TODO4AGENT_USERNAME / TODO4AGENT_PASSWORD로 계정을 지정하고 인증해야 합니다. (최초 실행 시 DB가 초기 계정 admin / admin123을 자동 생성합니다.) 인증에 실패하면 시작이 거부됩니다.

데이터

작업 데이터는 로컬 SQLite 데이터베이스에 저장되며, 화면의 「설정 → 데이터」에서 JSON을 내보내기/가져올 수 있습니다.

문서

• 개발자 문서: DEVELOPMENT.md

• 변경 로그: CHANGELOG.md

• 라이선스: GNU AGPL-3.0