feat: google calendar mcp server (#699)

* chore: init google calendar mcp server

* enhance: improve details, add readme, add example client

* feat: unit-test cases with pytest

* readme update

* remove legacy tool

* remove from index.yaml

* fix typo

* fix default MCP server path value

* fix: add support to uvx

* fix: support stdio

* fix: update project url

* adapt to latest changes, add dockerfile

* fix: pytest

* fix: mask error details

* fix: remove unnecessary reading from os.getnev

* add github action to build

Author: tybalex

.github/workflows/google-calendar-build.yaml

@@ -0,0 +1,58 @@
+name: Build release google-calendar
+
+permissions:
+  id-token: write
+  contents: read
+  packages: write
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'google/calendar/**'
+    branches:
+      - main
+
+jobs:
+  oss-tools-build:
+    runs-on: depot-ubuntu-22.04
+    concurrency:
+      group: google-calendar-build
+      cancel-in-progress: true
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ secrets.GHCR_USERNAME }}
+          password: ${{ secrets.GHCR_TOKEN }}
+
+      - name: Build and Push Docker image
+        uses: depot/build-push-action@v1
+        id: build-and-push
+        with:
+          project: bbqjs4tj1g
+          context: ./google/calendar
+          push: true
+          pull: true
+          platforms: linux/amd64,linux/arm64
+          tags: |
+            ghcr.io/${{ github.repository }}/google-calendar:latest
+
+      - name: Install Cosign
+        uses: sigstore/[email protected]
+        with:
+          cosign-release: 'v2.4.3'
+
+      - name: Sign Images
+        env:
+          DIGEST: ${{ steps.build-and-push.outputs.digest }}
+          TAGS: ghcr.io/${{ github.repository }}/google-calendar:latest
+        run: |
+          images=""
+          for tag in ${TAGS}; do
+            images+="${tag}@${DIGEST} "
+          done
+          cosign sign --yes ${images}

google/calendar/.python-version

@@ -0,0 +1 @@
+3.13

google/calendar/Dockerfile

@@ -0,0 +1,27 @@
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+# Prevents Python from writing .pyc files and buffers stdout/stderr
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+# Install system deps (if any needed) - using apt for Debian
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy uv project files first for better Docker layer caching
+COPY pyproject.toml uv.lock ./
+
+# Copy your application code (needed for local package build)
+COPY . .
+
+# Install dependencies using uv sync (faster and more reliable)
+RUN uv sync --frozen --no-dev --no-editable
+
+EXPOSE 9000
+
+# Start the server using uv run (ensures proper virtual environment)
+CMD ["uv", "run", "python", "-m", "app.server"]

google/calendar/README.md

@@ -0,0 +1,55 @@
+# Obot Google Calendar MCP Server
+
+- supports streamable HTTP and stdio
+
+## Installation & Running
+
+### Docker-compose (Recommended)
+Export (Google's) Oauth CLient ID and Secret for Oauth Proxy
+```bash
+export OAUTH_CLIENT_ID=xxx
+export OAUTH_CLIENT_SECRET=xxx
+```
+
+then:
+```bash
+docker-compose up
+```
+
+### Using uvx 
+install from local directory:
+```bash
+uvx --from . google-calendar-mcp
+```
+
+### Using uv (Development)
+Install dependencies:
+```bash
+uv pip install
+```
+
+Run the server:
+```bash
+uv run server.py
+```
+
+## Testing
+
+### Unit-test with pytest
+```bash
+uv run python -m pytest
+```
+
+### Integration Testing
+
+#### Get Your Access Token
+This MCP server assumes Obot will take care of the Oauth2.0 flow and supply an access token. To test locally or without Obot, you need to get an access token by yourself. I use [postman workspace](https://blog.postman.com/how-to-access-google-apis-using-oauth-in-postman/) to create and manage my tokens.
+
+#### Local Example Client
+```
+export GOOGLE_OAUTH_TOKEN=xxx
+```
+and then
+```
+uv run example_client.py
+```