google-workspace-mcp

Google Workspace 위의 5개의 독립적인 원격 MCP 서버 세트: Gmail, Google Calendar, Google Drive, Google Sheets 및 Google Docs.

상태: pre-alpha. 프로젝트는 활발히 개발 중이며, 공개 인터페이스와 구성은 첫 안정 릴리스 전에 변경될 수 있습니다.

서버는 의도적으로 분리되어 있습니다. 클라이언트 또는 프로젝트는 필요한 서비스만 포함하며, 정확히 해당 서비스에만 유효한 토큰을 받습니다: Gmail 토큰은 Drive를 열 수 없습니다. 공통으로 유지되는 것은 저장소, 인프라 라이브러리, 인증 프레임워크 및 배포 절차입니다.

서비스

각 서비스는 별도의 프로세스, 별도의 MCP 엔드포인트, 별도의 도구 레지스트리, 별도의 Google 권한 세트 및 별도의 자격 증명 저장소입니다.

두 가지 인증 계층

이들은 독립적이며 혼합되지 않습니다.

클라이언트 → 서비스. MCP 클라이언트는 PKCE 및 동적 등록을 사용하여 OAuth 2.1을 통과합니다. 발급된 토큰은 하나의 리소스에 바인딩되며, 재사용 감지와 함께 회전하는 refresh 토큰으로 갱신됩니다.

서비스 → Google. 서비스는 소유자를 대신하여 장기 refresh 토큰으로 Google 제품 API에 접근하며 access 토큰을 자체적으로 갱신합니다. Google 토큰은 어떤 경우에도 클라이언트에 반환되지 않습니다.

공식 Google MCP 엔드포인트는 Developer Preview에 있으며 여기서는 사용되지 않습니다: 호출은 안정적인 제품 API로 이루어집니다.

요구 사항

• Python 3.14, uv로 설치됨; 시스템 인터프리터는 영향을 받지 않습니다

• uv

• 5개 서비스 API와 OAuth 클라이언트가 활성화된 Google Cloud 프로젝트

설치

uv sync --dev

확인

uv run --no-sync pytest -q
uv run --no-sync ruff check .
uv run --no-sync ruff format --check .
uv run --no-sync mypy src

--no-sync 플래그는 종속성 버전 확인 시 필수입니다. 없으면 uv run이 잠금 파일에서 환경을 재동기화하고 실제 버전 대신 고정된 버전을 반환하여, 확실히 깨진 패키지 버전이 녹색 실행을 제공합니다.

출처

이 프로젝트는 jimprosser/obsidian-web-mcp의 OAuth 2.1 코어를 MIT에 따라 적응합니다. 전체 정보는 NOTICE에 있습니다.

다운스트림 OAuth 2.1의 기반은 리비전 7e6a52d791a50e3bd533df1060217973ab5be1c8입니다. 이후 코어에 클라이언트 및 토큰 수명 주기, refresh 토큰 회전, 재사용 감지 및 resource 정규화에 대한 자체 수정이 추가되었습니다.

원래 프로젝트의 도메인 부분 — Obsidian 저장소 작업 및 Git을 통한 동기화 — 는 이전되지 않았습니다.

여기서는 mcp>=2,<3이 사용됩니다: MCP 2.0에서 제거된 mcp.server.fastmcp 패키지는 필요하지 않으며, 자체 구성은 mcp.server.mcpserver에 기반합니다.

라이선스

MIT, LICENSE 참조.# google-workspace-mcp

Google Workspace 위의 5개의 독립적인 원격 MCP 서버 세트: Gmail, Google Calendar, Google Drive, Google Sheets 및 Google Docs.

상태: pre-alpha. 프로젝트는 활발히 개발 중이며, 공개 인터페이스와 구성은 첫 안정 릴리스 전에 변경될 수 있습니다.

서버는 의도적으로 분리되어 있습니다. 클라이언트 또는 프로젝트는 필요한 서비스만 포함하며, 정확히 해당 서비스에만 유효한 토큰을 받습니다: Gmail 토큰은 Drive를 열 수 없습니다. 공통으로 유지되는 것은 저장소, 인프라 라이브러리, 인증 프레임워크 및 배포 절차입니다.

서비스

각 서비스는 별도의 프로세스, 별도의 MCP 엔드포인트, 별도의 도구 레지스트리, 별도의 Google 권한 세트 및 별도의 자격 증명 저장소입니다.

두 가지 인증 계층

이 둘은 독립적이며 혼합되지 않습니다.

클라이언트 → 서비스. MCP 클라이언트는 PKCE 및 동적 등록을 사용하여 OAuth 2.1을 통과합니다. 발급된 토큰은 하나의 리소스에 바인딩되며, 재사용 감지와 함께 회전하는 refresh 토큰으로 갱신됩니다.

서비스 → Google. 서비스는 소유자를 대신하여 장기 refresh 토큰으로 Google 제품 API에 접근하며 access 토큰을 자체적으로 갱신합니다. Google 토큰은 어떤 경우에도 클라이언트에 반환되지 않습니다.

공식 Google MCP 엔드포인트는 Developer Preview에 있으며 여기서는 사용되지 않습니다: 호출은 안정적인 제품 API로 이루어집니다.

요구 사항

• Python 3.14, uv로 설치됨; 시스템 인터프리터는 영향을 받지 않습니다

• uv

• 5개 서비스 API와 OAuth 클라이언트가 활성화된 Google Cloud 프로젝트

설치

uv sync --dev

확인

uv run --no-sync pytest -q
uv run --no-sync ruff check .
uv run --no-sync ruff format --check .
uv run --no-sync mypy src

--no-sync 플래그는 의존성 버전 확인 시 필수입니다. 없으면 uv run이 잠금 파일에서 환경을 재동기화하고 실제 버전 대신 고정된 버전을 반환하여, 확실히 깨진 패키지 버전이 녹색 실행을 제공합니다.

출처

이 프로젝트는 jimprosser/obsidian-web-mcp의 OAuth 2.1 코어를 MIT에 따라 적응합니다. 전체 정보는 NOTICE에 있습니다.

다운스트림 OAuth 2.1의 기반은 리비전 7e6a52d791a50e3bd533df1060217973ab5be1c8입니다. 이후 코어에 클라이언트 및 토큰 수명 주기, refresh 토큰 회전, 재사용 감지 및 resource 정규화에 대한 자체 수정이 추가되었습니다.

원래 프로젝트의 도메인 부분 — Obsidian 저장소 작업 및 Git을 통한 동기화 — 는 이전되지 않았습니다.

여기서는 mcp>=2,<3이 사용됩니다: MCP 2.0에서 제거된 mcp.server.fastmcp 패키지는 필요하지 않으며, 자체 구성은 mcp.server.mcpserver에 기반합니다.

라이선스

MIT, LICENSE 참조.