MCP Google Drive Server

# 📖 Complete Setup Guide *Follow these steps to connect your AI assistant to Google Drive in about 10 minutes!* ## 🎯 Overview By the end of this guide, your AI assistant will be able to: - Read your Google Drive files - Search through your documents - Create new files - Edit existing files ## 📋 Before You Start Make sure you have: - ✅ A Google account with Google Drive - ✅ Claude Desktop installed on your computer - ✅ 10 minutes of free time ## 🚀 Step 1: Download the Project ### Option A: Download ZIP (Easiest) 1. Go to the [main project page](https://github.com/your-username/mcp-google-drive-server) 2. Click the green **"Code"** button 3. Click **"Download ZIP"** 4. Extract the ZIP file to your Desktop 5. Rename the folder to `google-drive-mcp` ### Option B: Use Git (For Developers) ```bash git clone https://github.com/your-username/mcp-google-drive-server.git cd mcp-google-drive-server ``` ## 🔧 Step 2: Install Node.js ### Windows 1. Go to [nodejs.org](https://nodejs.org/) 2. Download the **LTS version** (recommended) 3. Run the installer 4. Follow the setup wizard (keep all default settings) ### Mac 1. Go to [nodejs.org](https://nodejs.org/) 2. Download the **LTS version** (recommended) 3. Run the installer package 4. Follow the installation steps ### Verify Installation Open your terminal/command prompt and type: ```bash node --version ``` You should see something like `v18.17.0` or higher. ## 📦 Step 3: Install Dependencies 1. Open your terminal/command prompt 2. Navigate to your project folder: ```bash cd Desktop/google-drive-mcp ``` 3. Install the required packages: ```bash npm install ``` *This downloads all the code libraries needed to run the server.* ## 🔑 Step 4: Get Access to Google Drive We've made this super easy! We provide a pre-configured service account that you can use. ### Get the Service Account File 1. **Contact us aka Vilhelm** 2. **Save the file** in your project folder (same location as `package.json`) ### Share Your Google Drive Folders The service account needs permission to access your files: 1. **Open Google Drive** in your web browser 2. **Right-click** on any folder you want the AI to access 3. Click **"Share"** 4. In the "Add people and groups" box, paste this email: ``` mcp-drive-service@scientific-axle-461106-f3.iam.gserviceaccount.com ``` 5. Set the permission level: - **Viewer**: AI can only read files - **Editor**: AI can read and modify files (recommended) - **Owner**: AI has full control (not recommended) 6. Click **"Send"** **Repeat this for every folder** you want the AI to access. 💡 **Tip**: Share your main "Documents" folder to give the AI access to most of your files. ## 🧪 Step 5: Test the Setup Let's make sure everything works: 1. **Test basic functionality**: ```bash node test.js ``` You should see: ``` ✓ Node.js is working! ✓ MCP SDK imported successfully ✓ Google APIs imported successfully ``` 2. **Test Google Drive connection**: ```bash node debug-test.js ``` You should see: ``` ✓ Service account found: mcp-drive-service@... ``` If you see any errors, check our [🛠️ Troubleshooting Guide](TROUBLESHOOTING.md). ## ⚙️ Step 6: Configure Claude Desktop Now we need to tell Claude Desktop about your new MCP server. ### Find Your Config File **On Windows:** ``` %APPDATA%\Claude\claude_desktop_config.json ``` **On Mac:** ``` ~/Library/Application Support/Claude/claude_desktop_config.json ``` ### Edit the Config File 1. **Open the config file** in a text editor (Notepad on Windows, TextEdit on Mac) 2. **Replace the contents** with this (update the path to match your setup): ```json { "mcpServers": { "google-drive": { "command": "node", "args": ["C:/Users/YourName/Desktop/google-drive-mcp/server.js"], "env": {} } } } ``` **Important**: Replace `C:/Users/YourName/Desktop/google-drive-mcp/server.js` with the actual path to your `server.js` file. ### Get the Correct Path **On Windows:** 1. Open File Explorer 2. Navigate to your project folder 3. Hold Shift and right-click on `server.js` 4. Select "Copy as path" 5. Paste this path into the config file **On Mac:** 1. Open Finder 2. Navigate to your project folder 3. Right-click on `server.js` 4. Hold Option and select "Copy server.js as Pathname" 5. Paste this path into the config file ## 🎉 Step 7: Start Using It! 1. **Save** your config file 2. **Restart Claude Desktop** completely (quit and reopen) 3. **Open a new chat** in Claude 4. **Test it** by asking: "Can you list my Google Drive files?" If everything worked, Claude should be able to see and interact with your Google Drive files! ## ✅ Success! What Now? Now you can ask Claude to: ### 📁 Browse Files - "Show me my recent documents" - "List files in my 'Projects' folder" - "Find all PDF files in my Drive" ### 📖 Read Content - "Read the contents of my resume.pdf" - "What's in my meeting notes document?" - "Summarize the data in my spreadsheet" ### ✏️ Create & Edit - "Create a new document called 'Project Plan'" - "Add a task list to my existing project file" - "Update my resume with my latest experience" ### 🔍 Search - "Find all documents containing 'budget'" - "Show me files shared with me this week" - "Search for presentations about marketing" ## 🛟 Need Help? - 📖 Check our [FAQ](FAQ.md) - 🛠️ Try our [Troubleshooting Guide](TROUBLESHOOTING.md) - 💬 [Ask for help on GitHub](https://github.com/your-username/mcp-google-drive-server/issues) - 📧 Email us: support@yourproject.com **Congratulations! 🎉 You've successfully connected Claude to your Google Drive!**