Getting Started with MCPs in Gemini CLI

# Using npm
npm install -g @google/gemini-cli

# Using pip
pip install google-gemini-cli

# Verify installation
gemini --version

# Login to your Google account
gemini auth login

# Set your project ID
gemini config set project your-project-id

# Verify authentication
gemini auth status

# Install Google Workspace MCP
npm install -g @google/workspace-mcp-server

# Install Calendar MCP
npm install -g @modelcontextprotocol/server-calendar

# Install Gmail MCP
pip install gmail-mcp-server

mcp:
  servers:
    workspace:
      command: workspace-mcp-server
      args:
        - --scopes=drive,docs,sheets
      env:
        GOOGLE_APPLICATION_CREDENTIALS: /path/to/credentials.json
    
    calendar:
      command: calendar-mcp-server
      args:
        - --provider=google
      env:
        GOOGLE_CALENDAR_API_KEY: your_api_key
    
    gmail:
      command: python
      args:
        - -m
        - gmail_mcp_server
      env:
        GMAIL_CREDENTIALS: /path/to/gmail-credentials.json

gemini:
  model: gemini-pro
  temperature: 0.7
  max_tokens: 2048

mcp:
  servers:
    google_suite:
      command: node
      args:
        - google-suite-mcp.js
      env:
        GOOGLE_CLIENT_ID: your_client_id
        GOOGLE_CLIENT_SECRET: your_client_secret
        GOOGLE_REFRESH_TOKEN: your_refresh_token
      timeout: 30000
      
    cloud_storage:
      command: gcs-mcp-server
      args:
        - --bucket=your-bucket-name
        - --region=us-central1
      env:
        GOOGLE_CLOUD_PROJECT: your-project-id
        GOOGLE_APPLICATION_CREDENTIALS: /path/to/service-account.json

  global_settings:
    timeout: 60000
    retries: 3
    log_level: info

# Start Gemini with MCP servers
gemini start --with-mcp

# Query with workspace context
gemini ask "Summarize my recent Google Docs" --mcp workspace

# Calendar operations
gemini ask "What meetings do I have today?" --mcp calendar

# Start interactive session
gemini interactive

# In interactive mode:
> Use the Gmail MCP to check my unread emails
> Create a Google Doc summary using workspace MCP
> Schedule a meeting using calendar MCP

# Process multiple documents
gemini batch --input "*.md" --mcp workspace --prompt "Convert to Google Docs"

# Analyze calendar data
gemini analyze --mcp calendar --timeframe "last 30 days"

# List Google Drive files
gemini mcp call workspace list_files --folder "Projects"

# Create a new document
gemini mcp call workspace create_doc --title "Meeting Notes" --content "..."

# Share a document
gemini mcp call workspace share_doc --doc_id "abc123" --email "user@example.com"

# Check unread emails
gemini mcp call gmail get_unread --limit 10

# Send an email
gemini mcp call gmail send_email --to "user@example.com" --subject "Hello" --body "..."

# Search emails
gemini mcp call gmail search --query "from:boss@company.com"

# Get today's events
gemini mcp call calendar get_events --date today

# Create an event
gemini mcp call calendar create_event --title "Team Meeting" --start "2025-09-21T10:00:00"

# Find available time slots
gemini mcp call calendar find_free_time --duration 60 --participants "user1@example.com,user2@example.com"

# List configured MCP servers
gemini mcp list

# Start specific server
gemini mcp start workspace

# Stop server
gemini mcp stop workspace

# Restart all servers
gemini mcp restart

# Check server health
gemini mcp health workspace

# Enable debug logging
DEBUG=gemini:mcp gemini start

# View server logs
gemini mcp logs workspace --tail 50

# Test server connection
gemini mcp test workspace

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"

# Initialize OAuth flow
gemini auth oauth-init

# Complete OAuth setup
gemini auth oauth-complete --code your_auth_code

# Refresh tokens
gemini auth refresh

# Check authentication status
gemini auth status

# Re-authenticate
gemini auth login --force

# Clear cached credentials
gemini auth clear-cache

# Validate configuration
gemini config validate

# Test MCP connectivity
gemini mcp test-all

# Reset MCP configuration
gemini mcp reset

# Check API usage
gemini quota status

# Set rate limiting
gemini config set rate_limit 10

# Monitor API calls
gemini monitor --mcp workspace

# Development environment
gemini config set environment dev
gemini mcp start --dev-mode

# Testing configuration
gemini config test
gemini mcp validate-all

# Production deployment
gemini config set environment prod
gemini mcp start --production

# workflow.yaml
name: Daily Summary
trigger: cron("0 9 * * *")
steps:
  - name: Get calendar events
    mcp: calendar
    action: get_events
    params:
      date: today
  
  - name: Check emails
    mcp: gmail
    action: get_unread
    params:
      limit: 20
  
  - name: Create summary
    gemini: summarize
    context: [calendar_events, unread_emails]

// custom-gemini-mcp.js
const { MCPServer } = require('@modelcontextprotocol/sdk');

const server = new MCPServer({
  name: 'custom-gemini-tools',
  version: '1.0.0'
});

server.addTool('google_search', {
  description: 'Search Google with custom parameters',
  parameters: {
    query: { type: 'string', required: true },
    site: { type: 'string', required: false }
  },
  handler: async ({ query, site }) => {
    // Custom Google search implementation
    return { results: await customGoogleSearch(query, site) };
  }
});

server.start();