TickTick Calendar MCP Server

사내 일정관리 앱(TickTick)과 Obsidian(Claude Code) 연동을 위한 MCP 서버입니다.

설치

1. 클론

git clone https://github.com/plhyun22/ticktick-mcp-server.git
cd ticktick-mcp-server
npm install

2. 환경변수 설정

cp .env.example .env

.env 파일을 열어 아래 두 값을 설정합니다:

CALENDAR_SERVER_URL=http://[서버IP]:4000   # 관리자에게 문의
MCP_API_KEY=...                             # 관리자에게 문의

3. Claude Code에 MCP 등록

~/.claude/settings.json 파일에 아래 내용을 추가합니다:

{
  "mcpServers": {
    "ticktick-calendar": {
      "command": "node",
      "args": ["<클론한 경로>/index.js"],
      "env": {
        "CALENDAR_SERVER_URL": "http://[서버IP]:4000",
        "MCP_API_KEY": "..."
      }
    }
  }
}

자동 설치: 아래 Claude Code 설치 프롬프트를 사용하면 위 과정을 자동으로 처리합니다.

---

Claude Code 자동 설치 프롬프트

아래 텍스트를 복사하여 Claude Code 채팅창에 붙여넣으세요. [서버IP], [API_KEY], [클론경로]는 관리자에게 받은 값으로 교체하세요.

다음 작업을 순서대로 수행해줘:

1. 아래 경로에 ticktick-mcp-server 폴더를 만들고 이 저장소를 클론해줘:
   - Windows: C:\Users\{사용자명}\ticktick-mcp-server
   - Mac/Linux: ~/ticktick-mcp-server
   git clone https://github.com/plhyun22/ticktick-mcp-server.git <위 경로>

2. 클론한 폴더에서 npm install 실행

3. 클론한 폴더에 .env 파일 생성:
   CALENDAR_SERVER_URL=http://[서버IP]:4000
   MCP_API_KEY=[API_KEY]

4. 홈 디렉토리의 .claude/settings.json 파일을 열어서 (없으면 생성)
   mcpServers 항목에 아래 내용을 추가해줘:
   {
     "ticktick-calendar": {
       "command": "node",
       "args": ["<클론경로>/index.js"],
       "env": {
         "CALENDAR_SERVER_URL": "http://[서버IP]:4000",
         "MCP_API_KEY": "[API_KEY]"
       }
     }
   }

5. 설정 완료 후 사용 가능한 MCP 툴 목록을 알려줘.

---

Claude Code 업데이트 프롬프트

MCP 서버가 업데이트됐을 때 아래 텍스트를 복사하여 Claude Code 채팅창에 붙여넣으세요.

ticktick MCP 업데이트 해줘. ~/.claude/settings.json 에서 ticktick-calendar MCP 서버의 index.js 경로를 찾아서, 그 상위 폴더(git 저장소)에서 git pull 실행하고 결과 알려줘. 완료되면 Claude Code 재시작이 필요하다고 안내해줘.

---

사용 가능한 MCP 툴

툴	설명
list_users	팀원 프로필 목록 조회 (user_id 확인용)
list_calendars	전체 캘린더 목록 조회 (calendar_id 확인용)
parse_and_register	마크다운 텍스트 → AI 파싱 → 캘린더 등록
register_file	로컬 .md 파일 경로 → 직접 읽어서 등록

파라미터

parse_and_register / register_file 공통:

파라미터	필수	설명
content / file_path	✓	파싱할 텍스트 또는 파일 경로
calendar_id	✓	등록할 캘린더 ID (list_calendars로 확인)
user_id	-	작성자 유저 ID (list_users로 확인) — 생략 시 캘린더 소유자로 등록

사용 예시

팀 캘린더에 파일 등록

이 파일을 팀 캘린더에 등록해줘: /path/to/wiki/8월업무계획.md

개인 일정 등록 (프로필 지정)

아래 내용을 차태현 씨 캘린더에 일정으로 등록해줘:
- 8월 5일 오후 2시 서버 점검
- 8월 12일 팀 미팅

팀 일정 등록

아래 내용을 팀 캘린더에 일정으로 등록해줘:
- 8월 5일 오후 2시 전체 회의