이것은 Claude를 통해 Google Docs에 연결할 수 있는 Model Context Protocol (MCP) 서버입니다. 이 서버로, 당신은 할 수 있습니다:

• 드라이브의 모든 Google Docs 목록
• 특정 문서의 내용을 읽으십시오
• 새 문서 만들기
• 기존 문서 업데이트
• 문서 검색
• 문서 삭제

필수품

• Node.js v16.0.0 이상
• Google Docs API 및 Google Drive API를 사용한 Google Cloud 프로젝트
• Google Cloud 프로젝트의 OAuth 2.0 자격

설치

1. 이 저장소를 복제하고 프로젝트 디렉토리로 이동:

2. 의존성 설치:

3. Google Cloud Console의 OAuth 2.0 클라이언트 ID 생성:

• Google Cloud 콘솔로 이동
• 새로운 프로젝트를 만들거나 기존 하나를 선택
• Google Docs API 및 Google 드라이브 API 활성화
• "APIs & Services"로 이동 > “Credentials”
• "Create Credentials"을 클릭하십시오 > “OAuth 클라이언트 ID”
• 애플리케이션 유형의 "Desktop app"을 선택하십시오.
• JSON 파일을 다운로드하고 프로젝트 디렉토리에서 credentials.json로 저장하십시오.

Important: credentials.json과 token.json]]파일은 민감한 정보를 포함하고 .gitignore]를 통해 버전 제어에서 제외됩니다.

Google Docs MCP Server

This is a Model Context Protocol (MCP) server that allows you to connect to Google Docs through Claude. With this server, you can:

• List all Google Docs in your Drive
• Read the content of specific documents
• Create new documents
• Update existing documents
• Search for documents
• Delete documents

Prerequisites

• Node.js v16.0.0 or later
• Google Cloud project with the Google Docs API and Google Drive API enabled
• OAuth 2.0 credentials for your Google Cloud project

Setup

1. Clone this repository and navigate to the project directory:

git clone https://github.com/yourusername/MCP-Google-Doc.git
cd MCP-Google-Doc

2. Install dependencies:

npm install

3. Create an OAuth 2.0 client ID in the Google Cloud Console:

   • Go to the Google Cloud Console
   • Create a new project or select an existing one
   • Enable the Google Docs API and Google Drive API
   • Go to “APIs & Services” > “Credentials”
   • Click “Create Credentials” > “OAuth client ID”
   • Select “Desktop app” for the application type
   • Download the JSON file and save it as credentials.json in your project directory

   Important: The credentials.json and token.json files contain sensitive information and are excluded from version control via .gitignore. Never commit these files to your repository.

4. Build the project:

npm run build

5. Run the server:

npm start

The first time you run the server, it will prompt you to authenticate with Google. Follow the on-screen instructions to authorize the application. This will generate a token.json file that stores your access tokens.

Security Considerations

• Credential Security: Both credentials.json and token.json contain sensitive information and should never be shared or committed to version control. They are already added to the .gitignore file.
• Token Refresh: The application automatically refreshes the access token when it expires.
• Revoking Access: If you need to revoke access, delete the token.json file and go to your Google Account Security settings to remove the app from your authorized applications.

Connecting to Claude for Desktop

To use this server with Claude for Desktop:

1. Edit your Claude Desktop configuration file:

   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following to your configuration:

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

Replace /absolute/path/to/build/server.js with the actual path to your built server.js file.

Connecting to Claude Code

claude mcp add --transport stdio google-docs node /absolute/path/to/build/server.js

3. Restart Claude for Desktop.