Google Tasks MCP 서버

이 Model Context Protocol (MCP) 서버는 MCP 클라이언트와 Google Tasks 간의 가교 역할을 하여 Claude Desktop, Cursor, Codex와 같은 클라이언트에서 직접 작업 목록과 작업을 관리할 수 있도록 합니다.

기능

이 MCP 서버는 다음과 같은 기능을 제공합니다:

작업 목록 관리

• list-tasklists - 모든 작업 목록 나열

• get-tasklist - 특정 작업 목록에 대한 세부 정보 가져오기

• create-tasklist - 새 작업 목록 생성

• update-tasklist - 기존 작업 목록 업데이트

• delete-tasklist - 작업 목록 삭제

작업 관리

• list-tasks - 페이지네이션된 결과를 포함하여 작업 목록의 모든 작업 나열

• get-task - 특정 작업에 대한 세부 정보 가져오기

• create-task - 새 작업 생성

• update-task - 기존 작업 업데이트

• delete-task - 작업 삭제

• complete-task - 작업을 완료됨으로 표시

• move-task - 작업 이동(순서 변경, 상위 작업 변경 또는 작업 목록 간 이동)

• clear-completed-tasks - 목록에서 완료된 모든 작업 삭제

Related MCP server: Google Search MCP Server

설정 지침

1. Google Cloud 프로젝트 생성 및 API 활성화

1. Google Cloud Console로 이동합니다.

2. 새 프로젝트를 생성합니다.

3. "API 및 서비스" > "라이브러리"로 이동합니다.

4. "Google Tasks API"를 검색하여 활성화합니다.

5. "API 및 서비스" > "사용자 인증 정보"로 이동합니다.

6. "사용자 인증 정보 만들기" > "OAuth 클라이언트 ID"를 클릭합니다.

7. OAuth 동의 화면을 구성합니다(개인용으로는 외부(External)로 충분합니다).

8. 애플리케이션 유형으로 "웹 애플리케이션"을 선택합니다.

9. 승인된 리디렉션 URI로 "http://localhost:3000/oauth2callback"을 추가합니다.

10. 클라이언트 ID와 보안 비밀번호를 생성합니다.

2. 환경 변수 구성

이 프로젝트 디렉토리에 .env 파일을 생성합니다:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback

환경 변수:

• GOOGLE_CLIENT_ID (필수) - Google OAuth 클라이언트 ID

• GOOGLE_CLIENT_SECRET (필수) - Google OAuth 클라이언트 보안 비밀번호

• GOOGLE_REDIRECT_URI (선택 사항) - OAuth 리디렉션 URI (기본값: http://localhost:3000/oauth2callback)

참고: 서버는 시작 시 GOOGLE_CLIENT_ID와 GOOGLE_CLIENT_SECRET이 설정되어 있는지 확인하며, 누락되었거나 유효하지 않은 경우 명확한 오류 메시지와 함께 실패합니다.

3. 서버 빌드

1. 종속성 설치:

npm install

2. 서버 빌드:

npm run build

4. MCP 클라이언트 구성

Codex

~/.codex/config.toml에 서버를 추가합니다:

[mcp_servers.google-tasks]
command = "zsh"
args = ["-lc", "cd /path/to/google-tasks-mcp && exec node build/index.js"]

/path/to/google-tasks-mcp를 이 프로젝트의 경로로 바꾼 다음 Codex를 다시 시작합니다.

서버가 등록되었는지 확인하려면:

codex mcp list
codex mcp get google-tasks

Claude for Desktop

1. Claude for Desktop을 설치합니다.

2. Claude 구성 파일을 엽니다:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Google Tasks MCP 서버 구성을 추가합니다:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"]
    }
  }
}

경로를 자신의 값으로 바꾼 다음 Claude for Desktop을 다시 시작합니다.

인증 흐름

Google Tasks MCP 서버를 처음 사용할 때:

1. authenticate 도구를 사용하여 인증 URL을 가져옵니다.

2. 브라우저에서 해당 URL을 방문하여 Google 계정으로 로그인합니다.

3. 승인 후 브라우저 페이지에서 코드를 받습니다.

4. 이 코드로 set-auth-code 도구를 사용하여 인증을 완료합니다.

5. 이제 다른 모든 도구를 사용하여 Google Tasks와 상호 작용할 수 있습니다.

참고: 인증 토큰(새로 고침 토큰 포함)은 제한된 권한(600)으로 ~/.config/google-tasks-mcp/credentials.json에 자동으로 저장됩니다. 즉:

• 한 번만 인증하면 됩니다 - 자격 증명은 서버 재시작 후에도 유지됩니다.

• 자동 토큰 새로 고침 - 액세스 토큰은 저장된 새로 고침 토큰을 사용하여 만료 시(일반적으로 1시간 후) 자동으로 새로 고쳐집니다.

• 재인증 불필요 - 초기 설정 후에는 액세스 권한을 취소하거나 자격 증명 파일을 삭제하지 않는 한 다시 인증할 필요가 없습니다.

요구 사항

• Node.js 20+ (package.json 엔진 참조)

• MCP 호환 클라이언트

• Tasks API가 활성화된 Google Cloud 프로젝트

구현 특징

이 MCP 서버에는 다음과 같은 개선 사항이 포함되어 있습니다:

• 영구 토큰 저장 - 인증 자격 증명이 제한된 권한으로 디스크(~/.config/google-tasks-mcp/credentials.json)에 저장되므로 한 번만 인증하면 됩니다.

• 환경 변수 유효성 검사 - 시작 시 유효성 검사를 통해 필요한 자격 증명이 구성되었는지 확인하고 명확한 오류 메시지를 제공합니다.

• 자동 토큰 새로 고침 - OAuth 토큰이 만료되면 자동으로 새로 고쳐지므로 활성 세션 중이나 재시작 후에 다시 인증할 필요가 없습니다.

• 향상된 입력 유효성 검사 - ID 형식, 문자열 길이, RFC 3339 날짜 형식을 포함한 모든 입력에 대한 포괄적인 유효성 검사.

• HTML 살균(Sanitization) - XSS 취약점을 방지하기 위해 OAuth 콜백 응답을 살균합니다.

• 정상 종료(Graceful shutdown) - SIGINT/SIGTERM 신호 시 리소스의 적절한 정리.

• 타입 안전성 - 적절한 인터페이스를 갖춘 코드베이스 전체의 완전한 TypeScript 타입 안전성.

• 구성 가능한 리디렉션 URI - GOOGLE_REDIRECT_URI 환경 변수를 통해 OAuth 리디렉션 URI를 사용자 지정할 수 있습니다.

스크린샷

Claude Desktop

Cursor

라이선스

이 프로젝트는 데모 목적으로만 제공됩니다. 사용 시 위험은 사용자 본인의 책임입니다.