Enables sending emails with attachments, fetching and filtering emails, and analyzing email patterns for comprehensive email management and automation
Comprehensive Google Workspace integration providing 84 specialized tools covering Gmail, Calendar, Drive, and other Google services with centralized OAuth authentication
Provides file upload, search, and document management capabilities for organizing and accessing files stored in Google Drive
Offers data processing capabilities for Google Sheets as part of the comprehensive Google Workspace automation suite
Google Workspace MCP Service
A production-ready Google Workspace MCP service providing 84 specialized tools for comprehensive Google Workspace automation. Designed to run as a persistent background service integrating with Rube MCP for centralized OAuth authentication.
š Features
84 Custom Tools: Complete Google Workspace API coverage (83 tools + 1 auth via Composio)
MCP Service: Persistent background service with PM2 process management
Centralized Auth: OAuth handled by Composio/Rube (no client secrets on desktops)
TypeScript: Full type safety with modern ES2022 features
ES Modules: Native ES module support throughout
Auto-startup: Configurable boot-time service activation
Health Monitoring: Built-in health endpoints for service monitoring
PKCE Compliant: Solves security compliance for remote workforce
š Prerequisites
Node.js 18+ with npm
Anthropic API Key (optional, for AI features)
Google Workspace account for testing
š ļø Quick Start
1. Installation
2. Environment Setup
3. Development
šļø Project Structure
š¤ Google Workspace Agent
The GoogleWorkspaceAgent
class provides high-level methods for common workspace tasks:
š§ Custom Tools
Create specialized tools for your workspace needs:
š Authentication Flow
Option 1: Interactive Setup
Option 2: Pre-configured Connections
Configure connections via the Composio Dashboard and reference them by ID.
š Available Scripts
š Integration Examples
Gmail Integration
Calendar Integration
Google Drive Integration
š Advanced Workflows
Daily Summary Generation
Meeting Orchestration
š”ļø Error Handling
The project includes comprehensive error handling:
š API Reference
Composio Client
initializeComposio()
- Initialize SDK connectiongetAvailableTools(toolkits, userId)
- List available toolssetupAuthentication(userId, toolkit)
- Start OAuth flowwaitForAuthentication(requestId)
- Wait for auth completionexecuteTool(toolSlug, userId, arguments)
- Execute any tool
Google Workspace Agent
initialize(services)
- Setup agent with required servicessendEmail()
- Send emails with attachmentsgetRecentEmails()
- Fetch and filter emailscreateCalendarEvent()
- Create calendar eventsgetUpcomingEvents()
- List upcoming eventsuploadToDrive()
- Upload files to DrivesearchDriveFiles()
- Search Drive contentgenerateDailySummary()
- Generate daily activity summary
š§ Configuration
TypeScript Configuration
The project uses modern TypeScript settings in tsconfig.json
:
Target: ES2022
Module: ESNext
Strict mode enabled
Path aliases supported (
@/
āsrc/
)
Vite Configuration
Optimized for Node.js development:
ES modules output
Source maps enabled
Proper external handling
Path alias resolution
Code Quality
ESLint: TypeScript-aware linting with recommended rules
Prettier: Consistent code formatting
Pre-commit hooks: Automated formatting and linting
š¤ Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-feature
Make your changes and add tests
Run quality checks:
npm run lint && npm run typecheck
Commit your changes:
git commit -m 'Add amazing feature'
Push to the branch:
git push origin feature/amazing-feature
Open a Pull Request
š License
This project is licensed under the ISC License. See the LICENSE file for details.
š Troubleshooting
Common Issues
Authentication Errors
TypeScript Errors
Build Issues
Getting Help
š® What's Next?
Add Anthropic Claude integration for AI-powered email responses
Implement workflow scheduling and automation
Add support for Google Sheets data processing
Create dashboard for monitoring agent activities
Add unit tests and CI/CD pipeline
Built with ā¤ļø using Composio.dev - The platform for AI agents to take actions in the real world.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides 84 specialized tools for comprehensive Google Workspace automation including Gmail, Calendar, and Drive operations. Features persistent background service with centralized OAuth authentication through Composio for secure enterprise integration.
- š Features
- š Prerequisites
- š ļø Quick Start
- šļø Project Structure
- š¤ Google Workspace Agent
- š§ Custom Tools
- š Authentication Flow
- š Available Scripts
- š Integration Examples
- š Advanced Workflows
- š”ļø Error Handling
- š API Reference
- š§ Configuration
- š¤ Contributing
- š License
- š Troubleshooting
- š® What's Next?
Related MCP Servers
- -securityAlicense-qualityProvides authenticated access to Google Workspace APIs with a focus on Gmail operations and planned Calendar support, featuring secure OAuth authentication and multi-account management with detailed error handling.Last updated -100MIT License
- -securityAlicense-qualityIntegration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.Last updated -3MIT License
- -securityFlicense-qualityIntegrates with Google Drive to enable listing, reading, and searching over files, with automatic export of Google Workspace documents to appropriate formats.Last updated -634
- -securityFlicense-qualityEnables AI assistants to interact with Google Calendar through a simplified OAuth setup. Supports creating, editing, deleting, and searching calendar events without the complexity of Google Cloud Console configuration.Last updated -423