Google Task MCP

Google Tasks를 나열, 생성, 업데이트, 완료, 완료 취소, 삭제하는 로컬 MCP 서버 및 Codex 플러그인입니다. OAuth 2.0을 사용하며 Google Tasks 범위만 요청합니다:

https://www.googleapis.com/auth/tasks

요구 사항

• Node.js 20 이상

• Google Cloud 프로젝트

• Codex 또는 로컬 STDIO 서버를 지원하는 다른 MCP 클라이언트

Related MCP server: Google Tasks MCP Server

Google Cloud 설정

1. Google Cloud Console에서 프로젝트를 만들거나 선택합니다.

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

3. OAuth 동의 화면을 구성합니다. 앱이 테스트 중인 경우 자신을 테스트 사용자로 추가합니다.

4. Desktop app 유형의 OAuth 클라이언트 ID를 만듭니다. 클라이언트 구성이 리디렉션 URI 관리를 허용하는 경우 http://127.0.0.1:53682/oauth2callback을 승인된 리디렉션 URI로 추가합니다.

종속성 설치

npm install
npm run check

자격 증명 구성

Codex를 실행하는 환경에서 다음 변수를 설정합니다. .env.example에 필요한 값이 설명되어 있습니다. 서버는 의도적으로 .env를 자동으로 로드하지 않습니다.

GOOGLE_TASKS_CLIENT_ID
GOOGLE_TASKS_CLIENT_SECRET
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callback

선택적으로 GOOGLE_TASKS_TOKEN_PATH를 설정하여 로컬 OAuth 토큰이 저장될 위치를 지정할 수 있습니다.

Codex 플러그인으로 사용하기

저장소에는 이미 .codex-plugin/plugin.json 및 .mcp.json이 포함되어 있습니다. 로컬 Codex 플러그인 마켓플레이스를 통해 설치한 다음 Codex를 다시 시작하면 번들된 STDIO 서버와 도구 정의가 로드됩니다.

패키징 없이 개발하려면 다음을 사용하여 Codex에서 서버를 직접 구성하세요:

command: node
args: <absolute-repository-path>/server/index.js

Codex가 연결된 후 google_tasks_get_authorization_url을 호출하고 반환된 URL을 열어 액세스를 승인한 다음 google_tasks_complete_authorization을 호출합니다.

리프레시 토큰은 기본적으로 %APPDATA%\google-task-mcp\token.json에 로컬로 저장됩니다. GOOGLE_TASKS_TOKEN_PATH를 설정하여 다른 로컬 경로를 선택할 수 있습니다. 해당 파일을 제거하면 계정 연결이 해제됩니다.

도구 및 안전성

서버는 작업 목록 및 작업 나열, 작업 생성 및 업데이트, 작업 완료 또는 완료 취소, 작업 삭제 도구를 제공합니다. confirm이 true로 설정되지 않으면 삭제가 거부됩니다. 호출자는 먼저 삭제할 정확한 작업을 표시해야 합니다. 다른 변경 사항은 Google Tasks에 즉시 적용됩니다.

OAuth 인증을 위해서는 루프백 콜백 리스너가 계속 실행 중이어야 합니다. 브라우저 콜백은 간단한 성공 또는 오류 페이지를 표시하며 URL이나 도구 출력에 토큰이 노출되지 않습니다.

로컬 테스트

npm run check를 실행하여 구문을 확인하세요. OAuth/API 호출에는 구성된 자격 증명과 대화형 브라우저 인증이 필요합니다.

개인정보 보호

OAuth 자격 증명 및 작업 데이터는 Google API로 직접 전송되는 요청을 제외하고 로컬 머신에 남아 있습니다. .env 또는 생성된 토큰 파일을 커밋하지 마십시오. 둘 다 .gitignore에 의해 제외됩니다.

라이선스

MIT 라이선스에 따라 배포됩니다.