owners-manual-mcp

Google Drive MCP Server

A Model Context Protocol (MCP) server that provides access to Google Drive documents through OAuth2 authentication.

Features

• OAuth2 authentication with Google Drive
• List documents from Google Drive
• Search documents by text content
• Retrieve document metadata and content
• Support for Google Docs, Sheets, and other file types
• MCP integration for LLM access

Setup

• Install dependencies:

npm install

• Configure environment variables:

cp .env.example .env

Edit .env with your Google OAuth credentials.

Usage

Development Server (Express)

npm run dev

MCP Server

npm run mcp

Production

npm run build
npm start

API Endpoints

Express Server

• GET /health - Health check
• GET /auth/google - Get OAuth URL
• GET /auth/google/callback - Handle OAuth callback
• GET /list-documents - List all documents
• GET /search?q=<query> - Search documents
• GET /document/:id - Get document content
• GET /folders - List folders
• GET /docs - API documentation

MCP Tools

The MCP server provides the following tools for LLMs:

• list_documents - List all available documents
• get_document_content - Get content of a specific document
• search_documents - Search documents by text content

Flow Example

• User asks: "How do I configure my platform?"
• LLM calls: list_documents() to see available documents
• MCP returns: List of documents including "Configuring your platform"
• LLM calls: get_document_content(fileId) with the specific document
• MCP returns: Full content of the document
• LLM responds: With information from the document

Google OAuth Setup

• Go to Google Cloud Console
• Create a new project or select existing one
• Enable the Google Drive API
• Create OAuth2 credentials:
  • Application type: Web application
  • Authorized redirect URIs: http://localhost:3000/auth/google/callback
• Download the credentials and add to .env

Token Renewal

📋 Para renovar tokens expirados, consulte: TOKEN_RENEWAL_GUIDE.md

O guia contém instruções detalhadas para renovar tokens usando o Google OAuth2 Playground.

License

MIT License