gtasks-mcp

Google Tasks용 Model Context Protocol 서버 — Claude(또는 MCP 호환 클라이언트)에서 작업을 나열, 검색, 생성, 업데이트, 삭제 및 완료 처리할 수 있습니다.

zcaceres/gtasks-mcp(MIT)에서 각색했으며, Bun 대신 순수 Node/TypeScript로 재구축했습니다. 자격 증명은 저장소에서 완전히 분리했고(아래 보안 참조), 전체 테스트 스위트를 포함합니다.

설정

1. Google Cloud OAuth 클라이언트 만들기

1. Google Cloud Console로 이동하여 프로젝트를 만들거나 기존 프로젝트를 재사용합니다.

2. Google Tasks API를 사용 설정합니다(APIs & Services → Library).

3. OAuth 동의 화면을 구성합니다(개인용으로는 External이면 충분합니다 — 테스트 사용자는 본인뿐입니다).

4. 사용자 인증 정보 만들기 → OAuth 클라이언트 ID → 애플리케이션 유형 데스크톱 앱을 선택합니다.

5. JSON 파일을 다운로드합니다.

2. OAuth 클라이언트 파일 설치

mkdir -p ~/.gtasks-mcp
mv ~/Downloads/client_secret_*.json ~/.gtasks-mcp/oauth-keys.json

Windows의 경우: %USERPROFILE%\.gtasks-mcp\oauth-keys.json.

3. 빌드 및 인증

npm install
npm run build
npm run auth

이 과정에서 Google 동의 흐름을 위한 브라우저 창이 열립니다. 성공하면 ~/.gtasks-mcp/의 oauth-keys.json 옆에 credentials.json(리프레시/액세스 토큰)이 생성됩니다.

4. Claude Code에 서버 등록

claude mcp add gtasks -- node /absolute/path/to/gtasks-mcp/dist/index.js

Related MCP server: mcp-google-tasks

제공되는 도구

보안

• 자격 증명은 이 저장소에 절대 저장되지 않습니다. oauth-keys.json(Google Cloud OAuth 클라이언트)과 credentials.json(npm run auth로 생성된 개인 액세스/리프레시 토큰)은 모두 ~/.gtasks-mcp/에 저장됩니다 — 프로젝트 디렉터리가 아닌 OS 사용자 구성 영역입니다. 저장소 내부에 실수로 git add -f할 수 있는 gitignore된 파일이 없으며, 비밀 정보는 저장소 작업 트리에서 전혀 접근할 수 없습니다. 정확한 경로는 src/config.ts를 참조하세요.

• credentials.json은 Google Tasks의 비밀번호와 동일합니다 — 이 파일을 가진 사람은 누구나 당신의 작업을 읽고 쓸 수 있습니다. 그에 맞게 취급하세요(이메일로 보내지 말고, 채팅에 붙여넣지 말고, 공유 위치에 백업하지 마세요).

• 의존성: @google-cloud/local-auth, googleapis, @modelcontextprotocol/sdk만 사용합니다 — 모두 공식(Google/Anthropic)입니다. 원격 측정(telemetry)이 없고, 제3자 네트워크 호출이 없으며, 모든 요청은 Google의 자체 API로 전송됩니다.

• 알려진, 수용된 전이적 취약점(npm audit, 2026-08-25 확인): esbuild/vite(개발 전용 도구, 런타임에 포함되지 않음) 및 uuid(gaxios/googleapis를 통해, 이 서버의 실제 사용에서 신뢰할 수 없는 버퍼 입력 경로 없음)에 중간 심각도 문제가 있습니다. 두 경우 모두 상위 패키지의 주요 버전 업그레이드가 필요하며, 테스트되지 않은 업그레이드를 강제하기보다 다음 정기 의존성 감사에서 재검토하세요.

개발

npm test        # vitest
npm run lint     # eslint (narrow scope — see eslint.config.js)
npm run typecheck
npm run build