Google 문서 MCP 서버

이는 Claude를 통해 Google Docs에 연결할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 사용하면 다음과 같은 작업을 수행할 수 있습니다.

드라이브에 있는 모든 Google 문서 나열
특정 문서의 내용을 읽어보세요
새 문서 만들기
기존 문서 업데이트
문서 검색
문서 삭제

필수 조건

Node.js v16.0.0 이상
Google Docs API 및 Google Drive API가 활성화된 Google Cloud 프로젝트
Google Cloud 프로젝트에 대한 OAuth 2.0 자격 증명

설정

이 저장소를 복제하고 프로젝트 디렉토리로 이동합니다.

지엑스피1

종속성 설치:

npm install

Google Cloud Console에서 OAuth 2.0 클라이언트 ID를 만듭니다.
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- Google Docs API 및 Google Drive API 활성화
- "API 및 서비스" > "자격 증명"으로 이동하세요.
- "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
- 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요
- JSON 파일을 다운로드하여 프로젝트 디렉토리에 credentials.json 으로 저장합니다.
중요 : credentials.json 및 token.json 파일에는 민감한 정보가 포함되어 있으며 .gitignore 통한 버전 관리에서 제외됩니다. 이 파일들을 저장소에 커밋하지 마세요.
프로젝트를 빌드하세요:

npm run build

서버를 실행합니다:

npm start

서버를 처음 실행하면 Google 인증을 하라는 메시지가 표시됩니다. 화면의 안내에 따라 애플리케이션을 승인하세요. 그러면 액세스 토큰을 저장하는 token.json 파일이 생성됩니다.

보안 고려 사항

자격 증명 보안 : credentials.json 과 token.json 모두 민감한 정보를 포함하고 있으므로 공유하거나 버전 관리 시스템에 커밋해서는 안 됩니다. 이 두 파일은 이미 .gitignore 파일에 추가되어 있습니다.
토큰 새로 고침 : 애플리케이션은 액세스 토큰이 만료되면 자동으로 새로 고침합니다.
액세스 취소 : 액세스를 취소해야 하는 경우 token.json 파일을 삭제하고 Google 계정 보안 설정 으로 이동하여 권한이 부여된 애플리케이션에서 앱을 제거하세요.

데스크톱용 Claude에 연결

Claude for Desktop과 함께 이 서버를 사용하려면:

Claude Desktop 구성 파일을 편집하세요.
- macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json
구성에 다음을 추가하세요.

{
  "mcpServers": {
    "googledocs": {
      "command": "node",
      "args": ["/absolute/path/to/build/server.js"]
    }
  }
}

/absolute/path/to/build/server.js 빌드한 server.js 파일의 실제 경로로 바꾸세요.

데스크톱에서 Claude를 다시 시작합니다.

사용자 인터페이스

Google Docs MCP 서버는 다음과 같은 사용자 친화적인 대화형 인터페이스를 제공합니다.

문서 정보를 깔끔하고 읽기 쉬운 형식으로 표시합니다.
원시 API 데이터 대신 자연어 응답을 사용합니다.
사람이 읽을 수 있는 방식으로 날짜를 형식화합니다.
작업 후 유용한 후속 질문을 제공합니다.
OAuth 토큰과 같은 민감한 데이터를 노출하지 않습니다.

이 인터페이스 스타일은 Notion 등 다른 Claude MCP 통합과 일치하도록 디자인되어 일관되고 즐거운 사용자 경험을 제공합니다.

개발

프로젝트 구조

google-docs-integration/
├── build/                # Compiled JavaScript files
├── src/                  # TypeScript source code
│   └── server.ts         # Main server implementation
├── .gitignore            # Git ignore file
├── credentials.json      # OAuth 2.0 credentials (not in version control)
├── package.json          # Project dependencies and scripts
├── README.md             # Project documentation
├── token.json            # OAuth tokens (not in version control)
└── tsconfig.json         # TypeScript configuration

새로운 기능 추가

MCP 서버에 새로운 기능을 추가하려면:

새로운 기능을 구현하려면 src/server.ts 파일을 수정하세요.
npm run build 로 프로젝트를 빌드하세요.
npm start 실행하여 변경 사항을 테스트하세요.

사용 가능한 리소스

googledocs://list - 드라이브에 있는 모든 Google 문서를 나열합니다.
googledocs://{docId} - ID로 특정 문서의 내용을 가져옵니다.

사용 가능한 도구

create-doc - 지정된 제목과 선택적 콘텐츠로 새 Google 문서를 만듭니다.
update-doc - 기존 Google 문서를 새 콘텐츠로 업데이트합니다(추가 또는 교체).
insert-text - Notion이나 다른 통합 없이 문서에 텍스트를 직접 삽입합니다.
search-docs - 특정 텍스트가 포함된 Google Docs 검색
delete-doc - ID로 Google 문서를 삭제합니다.

사용 가능한 프롬프트

create-doc-template - 지정된 주제와 글쓰기 스타일을 기반으로 새 문서를 만드는 데 도움이 됩니다.
analyze-doc - 문서의 내용을 분석하고 요약을 제공합니다.

사용 예

서버가 연결되면 Claude와 함께 사용할 수 있는 몇 가지 프롬프트 예는 다음과 같습니다.

"내 모든 Google 문서 목록을 보여주세요"
"'회의 메모'라는 제목으로 '토론 주제: ...'라는 내용의 새 Google 문서를 만듭니다."
"ID가 '1abc123def456'인 문서를 업데이트하여 마지막에 이 섹션을 추가하세요: ..."
"Google 문서에서 '프로젝트 제안서'가 포함된 문서를 검색하세요."
"ID가 '1abc123def456'인 Google 문서를 삭제하세요."
"기후 변화에 대한 공식 문서를 작성하세요"
"ID '1abc123def456'을 가진 문서의 내용을 분석합니다."

문제 해결

인증 문제가 발생하는 경우:

프로젝트 디렉토리에서 token.json 파일을 삭제하세요.
새로운 인증 흐름을 트리거하려면 서버를 다시 실행하세요.

Google Docs API에 문제가 있는 경우:

Google Cloud Console에서 API가 활성화되어 있는지 확인하세요.
OAuth 자격 증명의 범위가 올바른지 확인하세요.

기여하다

저장소를 포크하세요
기능 브랜치를 만듭니다: git checkout -b feature/your-feature-name
변경 사항을 커밋하세요: git commit -am 'Add some feature'
브랜치에 푸시: git push origin feature/your-feature-name
풀 리퀘스트 제출

특허

MIT

환경 변수

다음 키를 사용하여 프로젝트 루트에 .env 파일을 만듭니다(또는 셸에서 변수를 내보냅니다).

# OAuth 2.0 client credentials – **JSON string** of the credentials file
GOOGLE_DOCS_CREDENTIALS_JSON={...}

# OAuth token – **JSON string** returned by the OAuth consent flow
GOOGLE_DOCS_TOKEN_JSON={...}

이러한 변수가 설정되면 서버는 디스크에서 credentials.json 이나 token.json 읽으려고 시도 하지 않습니다 .

Google Docs MCP Server

Integrations