Google Tasks MCP

AI 에이전트가 사용자의 Google Tasks를 읽고 관리할 수 있게 해주는 MCP 서버입니다. Google의 공식 Tasks API, OAuth 2.0 Desktop App 자격 증명, 그리고 stdio를 통해 동작하는 MCP TypeScript SDK를 사용합니다.

기능

• 작업 목록 나열, 조회, 생성, 이름 변경, 삭제

• API 페이지네이션으로 작업 나열 및 필터링

• 작업 생성, 편집, 완료, 다시 열기, 이동, 순서 변경, 삭제

• parent와 previous를 사용한 하위 작업 생성 및 이동

• 완료된 작업 지우기

• 파괴적 작업에 대한 MCP 안전 주석 및 명시적 확인

• 소유자 전용 권한으로 저장소 외부에 저장되는 OAuth 리프레시 토큰

요구 사항

• Node.js 20 이상

• Google 계정

• Google Tasks API가 사용 설정된 Google Cloud 프로젝트

1. Google Cloud 구성

1. Google Cloud Console을 엽니다.

2. 프로젝트를 만들거나 선택합니다.

3. APIs & Services → Library에서 Google Tasks API를 사용 설정합니다.

4. OAuth 동의 화면을 구성합니다.

5. APIs & Services → Credentials에서 애플리케이션 유형 Desktop app으로 OAuth 클라이언트 ID를 만듭니다.

6. OAuth Desktop 클라이언트 JSON을 client_secret.json으로 다운로드하고 이 저장소 외부에 안전하게 보관합니다.

2. 설치, 빌드 및 인증

npm install
npm run build
npm run auth -- --client-secret /secure/google/client_secret.json

인증 명령은 최상위 installed 객체를 포함한 Google OAuth Desktop 클라이언트 JSON만 허용합니다. 브라우저 동의 흐름을 열고 Tasks 리프레시 토큰을 다음 위치에 저장합니다.

~/.config/google-tasks-mcp/token.json

필요한 경우 생성된 토큰 위치를 재정의합니다.

GOOGLE_TOKEN_FILE=/secure/google/tasks-token.json \
npm run auth -- --client-secret /secure/google/client_secret.json

설치된 패키지인 경우 실행합니다.

google-tasks-mcp-auth --client-secret /secure/google/client_secret.json

이 서버는 읽기 및 쓰기 작업을 모두 제공하므로 전체 https://www.googleapis.com/auth/tasks 범위를 요청합니다. 이후 MCP 서버 실행 시 저장된 토큰을 사용하고 액세스를 자동으로 갱신합니다. client_secret.json은 프로젝트를 인증하거나 다시 인증할 때에만 다시 제공하면 됩니다. 두 JSON 파일을 모두 커밋하지 마세요.

3. MCP 호스트 연결

이 저장소에서 빌드된 서버를 직접 사용하세요. 경로는 사용자 머신의 절대 경로로 바꾸세요.

Codex (~/.codex/config.toml)

[mcp_servers.google_tasks]
command = "node"
args = ["/absolute/path/google-task-mcp/dist/index.js"]

[mcp_servers.google_tasks.env]
GOOGLE_TOKEN_FILE = "/Users/you/.config/google-tasks-mcp/token.json"

JSON 구성을 사용하는 호스트

{
  "mcpServers": {
    "google_tasks": {
      "command": "node",
      "args": ["/absolute/path/google-task-mcp/dist/index.js"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/Users/you/.config/google-tasks-mcp/token.json"
      }
    }
  }
}

구성 변경 후 MCP 호스트를 다시 시작합니다.

사용 가능한 도구

Google Tasks는 기한 타임스탬프의 날짜 부분만 저장합니다. API로 전송된 시각 정보는 무시됩니다. 작업 제목은 1,024자, 메모는 8,192자로 제한됩니다.

MCP Inspector로 테스트

npm run build
npm run inspect

stdio 프로토콜은 stdout만 사용합니다. 따라서 런타임 진단 메시지는 stderr로 기록됩니다.

배포용 패키지 만들기

설치 가능한 npm tarball을 생성합니다.

npm pack

패키지를 게시한 후 호스트에서 다음 명령으로 실행할 수 있습니다.

{
  "command": "npx",
  "args": ["-y", "google-tasks-mcp@0.1.0"],
  "env": {
    "GOOGLE_TOKEN_FILE": "/secure/google/tasks-token.json"
  }
}

한 사용자가 한 워크스테이션에서 사용하는 경우 stdio와 로컬 토큰이 가장 간단하고 안전한 배포 방식입니다. 여러 사용자 또는 호스팅 서비스의 경우 MCP Streamable HTTP를 사용하고 사용자별 OAuth 세션과 암호화된 서버 측 토큰 저장소를 구현하세요. 사용자 간에 하나의 리프레시 토큰을 공유하면 안 됩니다.

참고 자료

• Google Tasks API REST 참조

• Google Tasks 리소스 필드

• Google Tasks 정렬

• Google OAuth 2.0

• MCP TypeScript SDK