수업 자료 제작
학교 서식 같은 교수·학습 과정안과 이름 칸·답 칸이 있는 학습지를 A4 Docs로, 차시별 발표 자료를 Slides로 생성합니다.
읽기 전용 Agent · 1.1.2
새 경로는 Google 읽기 권한 다섯 개와 별도 원격 MCP 인증을 사용합니다. 일반 사용자는 Cloud 프로젝트나 Google JSON을 준비하지 않습니다. 실제 두 계정의 로그인·읽기·갱신·계정 분리·연결 해제와 무료 운영 검증을 마쳤습니다. 정식 npm 설치본과 실제 Codex 연결도 확인했습니다. Agent 설치 안내에서 연결하세요.
고정된 다음 날 종료 없이 무료 한도 안에서 운영합니다. 공식 요금 조건을 자동 확인하고 조건 변경·48시간 확인 실패·사용량 초과 시 요청을 차단하며 유료로 전환하지 않습니다. 전체 조회는 분당40회·하루600회, 연결별 하루100회입니다.
아래 제작·Classroom·공유 예시는 기존 로컬 고급 경로의 기능입니다. 새 읽기 전용 Agent는 지정한 Docs·Sheets·Slides·Forms 읽기, 연결 상태 확인, 로컬 교육과정 조회를 제공합니다. 기존 latest 1.1.1과 새 Agent의 agent 태그를 구분해 설치하세요.
Google Workspace for Education × AI
Edu Workspace MCP는 AI가 Google Docs, Sheets, Slides, Forms, Drive와 Classroom에서 교사의 기존 자료를 읽고 분석하며 새로운 결과물을 만들도록 연결하는 오픈소스 도구입니다.
Version 1.0.0
Node.js 20 이상이 필요합니다. 사용하는 AI 클라이언트 명령 하나와 Google 로그인 명령을 실행하세요.
npx -y edu-workspace-mcp@1.0.0 install claude --read
# 또는 install codex / claude-desktop / cursor --read
npx -y edu-workspace-mcp@1.0.0 login --read
교육 업무에 맞춘 도구
한 번의 요청으로 여러 Google 교육도구를 연결해 일관된 수업 패키지를 만들 수 있습니다.
학교 서식 같은 교수·학습 과정안과 이름 칸·답 칸이 있는 학습지를 A4 Docs로, 차시별 발표 자료를 Slides로 생성합니다.
평가·제출·관찰 기록과 대시보드가 연결된 Sheets를 만들고, Forms 퀴즈를 생성합니다.
담당 수업을 확인하고 과제 초안을 만든 뒤, 교사의 명시적 승인 후 게시합니다.
교과·단원별 폴더와 파일을 만들고, 공유는 대상과 권한을 확인한 뒤 적용합니다.
셀 내용을 노출하지 않고 탭 구조·수식 의존성·오류·차트와 검증 규칙을 점검합니다.
Classroom의 제출·지각·점수를 읽어 개인정보를 최소화한 Sheets 스냅샷을 만듭니다.
2022 개정 교육과정 성취기준 620개를 로그인 없이 찾고, 과정안·평가계획·퀴즈에 정리된 원문과 출처를 넣습니다.
복사해서 바로 쓰는 프롬프트
좋은 결과는 대상, 용도, 정보 구조, 읽기 밀도와 완료 조건이 분명합니다. 아래 예시는 실제 지원 기능에 맞춰 구성했으며, [대괄호]만 내 수업에 맞게 바꾸면 됩니다.
2026학년도 [5학년 3반] [2학기] 과정중심평가 시스템을 Google Sheets로 만들어줘. 학생은 학생01부터 학생24까지, 교과는 국어·사회·수학·과학·영어로 구성하고 평가 수준은 매우잘함·잘함·보통·노력요함으로 해줘.
반드시 전용 과정중심평가 템플릿을 사용해서 학생명단, 평가계획, 평가기록, 학생별현황, 제출현황, 관찰기록, 대시보드, 안내, 설정 탭이 서로 연결되게 만들어줘. 입력 칸은 행 높이를 넉넉하게 하고, 긴 성취기준·관찰기록·피드백 열은 충분히 넓혀 줄바꿈해줘. 표 머리글은 고정하고 제목·입력 영역·자동 계산 영역이 한눈에 구분되게 해줘. 드롭다운, 체크박스, 조건부 서식과 교과별 평균 차트도 포함해줘.
완료하기 전에 학생 24명과 교과 5개가 모두 들어갔는지, 수식·드롭다운·차트가 연결됐는지 확인하고 결과 링크와 탭별 사용 순서를 짧게 알려줘.
[5학년 국어] ‘[4. 의견을 조정해요 — 1. 의견을 조정하며 토의하기]’ 교수·학습 과정안을 만들어줘. 교과서는 [182~193쪽], [4차시]야.
먼저 초등 성취기준에서 ‘[토의]’와 관련된 코드를 찾아 보여주고 내가 고르면, 그 코드로만 성취기준을 넣어줘(원문을 직접 쓰지 마). 과정안 양식으로 기본 정보표, 핵심 용어, 차시별 흐름표, 차시마다 학습 문제와 도입·전개·정리 과정표(학습 과정·교수·학습 활동·시간·자료 ▣·유의점 ※), 상·중·하 평가 계획, 지도상 유의점을 채워줘.
완료 전에 차시별 시간 합이 40분인지, 활동이 교과서 쪽수와 맞는지 확인하고 문서 링크를 알려줘.
[5학년 국어] ‘[의견을 조정하며 토의하기]’ 학생용 학습지를 학습지 양식으로 만들어줘. 학년·반·번호·이름 칸과 학생 눈높이의 학습 목표 한 문장을 넣어줘.
활동은 순서대로 ① 토의 주제 정하기: 상황별 문제를 쓰는 표 ② 의견 마련하기: ‘의견’·‘그 이유’ 이름표가 붙은 줄 칸 ③ 친구 의견의 장점·단점 표 ④ 검토 기준 × 의견 평가표(◎○△) ⑤ ‘수정한 의견’ 칸 ⑥ ○로 표시하는 자기 점검표와 ‘노력할 점’ 칸으로 해줘. 물음은 짧게 쓰고, 어려운 물음 아래에는 도움말을 한 줄 붙여줘.
완료 전에 답을 쓸 공간이 충분한지, 인쇄했을 때 2쪽을 넘지 않는지 확인하고 문서 링크를 알려줘.
초등 [5~6학년] [사회] 성취기준 중 ‘[유적]’, ‘[유물]’과 관련된 것을 찾아 코드와 원문을 표로 보여줘. 원문 확인이 필요한 항목이 있으면 따로 표시해줘.
내가 코드를 고르면, 그 성취기준으로 [5학년 3반] [2학기] 과정중심평가 시트의 평가계획 탭을 미리 채워서 만들어줘. 학생은 학생01부터 학생24까지로 해줘. 성취기준 원문은 직접 쓰지 말고 코드로만 넘겨줘.
[5학년 3반] 학생 24명이 사용할 2학기 독서 기록장을 Google Sheets로 만들어줘. ‘사용안내’, ‘독서기록’, ‘학생별현황’, ‘월별현황’ 탭을 만들고, 독서기록에는 날짜·번호·학생이름·책 제목·저자·읽은 쪽수·한 줄 감상 열을 넣어줘. 학생 이름은 학생01부터 학생24까지 사용해줘.
첫 행은 고정하고 모든 입력 행은 읽고 클릭하기 편한 높이로, 책 제목과 한 줄 감상 열은 넓게 만들어 줄바꿈해줘. 머리글과 본문을 색과 굵기로 구분하고 번갈아 보이는 행 배경을 적용해줘. 학생별 누적 권수와 읽은 쪽수, 월별 독서량은 수식으로 자동 집계되게 해줘. 빈 탭이나 의미 없는 열은 만들지 말아줘.
완료 후 탭 이름, 학생 수, 핵심 수식이 올바른지 확인하고 링크와 입력 시작 위치를 알려줘.
[4학년 사회] ‘[우리 지역의 문화유산]’ 도입 수업 자료를 Google Slides 7장으로 만들어줘. 순서는 표지 → 호기심을 여는 질문 → 학습 목표 → 핵심 개념 → 사례 비교 → 모둠 활동 안내 → 정리 질문으로 해줘.
한 슬라이드에는 핵심 메시지 하나만 두고 제목은 짧게, 본문은 최대 4개 항목으로 제한해줘. 교실 뒤에서도 읽을 수 있도록 긴 문장을 줄이고, 활동 안내는 ‘무엇을·어떻게·몇 분 동안’ 하는지 보이게 써줘. 모든 슬라이드는 같은 어조와 구조를 유지하고 마지막 장은 학생이 바로 대답할 수 있는 질문으로 끝내줘.
완료 전에 슬라이드 수, 글자량, 내용 중복과 수업 흐름을 점검하고 발표 자료 링크와 장별 요약을 알려줘.
[5학년 수학] ‘[분수의 곱셈]’ 형성평가를 Google Forms 퀴즈로 만들어줘. 객관식 5문항과 단답형 2문항, 서술형 1문항으로 구성하고 총점은 20점으로 해줘.
앞 문항은 개념 확인, 뒤 문항은 적용과 설명 순서가 되게 난이도를 배치해줘. 객관식 선택지는 길이와 표현 방식을 비슷하게 맞추고 흔한 오개념을 오답에 반영해줘. 각 문항에 정답과 배점을 넣고, 첫 화면 설명에는 평가 목적·예상 시간 10분·제출 전 확인 사항을 짧게 써줘. 개인정보를 묻는 새 문항은 추가하지 말아줘.
완료 전에 문항 수, 총점, 객관식 정답이 선택지에 포함됐는지 확인하고 교사용 편집 링크와 학생용 응답 링크를 구분해서 알려줘.
Drive에서 이름에 ‘[2학기 수행평가]’가 들어간 파일을 찾아 문서·시트·슬라이드·설문으로 나누어 보여줘. 같은 이름의 파일은 수정 시각과 위치를 함께 표시해 구분해줘.
그다음 내 Drive에 ‘[2026/5학년/2학기 수행평가]’ 폴더 구조를 만들어줘. 기존 파일은 이동하거나 공유하지 말고, 검색 결과와 새로 만든 폴더 링크만 알려줘. 실제 학생 이름이나 점수는 응답에 반복하지 말아줘.
내가 담당하는 활성 Classroom 수업에서 ‘[5학년 3반 과학]’을 먼저 찾아줘. ‘[우리 몸의 기관 조사]’ 과제를 학생에게 아직 보이지 않는 초안으로 만들어줘. 만점은 20점, 마감은 [2026년 9월 11일 오후 6시]로 해줘.
과제 설명은 ‘학습 목표 → 해야 할 일 3단계 → 제출 형식 → 평가 기준 4개 → 제출 전 점검’ 순서로, 학생이 혼자 읽고 수행할 수 있게 써줘. 내가 지정한 자료만 첨부하고 게시하지는 마. 초안 생성 후 수업명·제목·마감·배점·첨부 링크를 한 번에 보여주고 내 확인을 기다려줘.
이 Google Docs 수업안과 Google Slides 발표 자료를 읽고 학습 목표, 활동 순서, 준비물, 평가 방법을 표로 비교해줘. 서로 다르게 적힌 내용과 수업 중 학생이 혼동할 지점을 먼저 알려줘.
이어서 수정 우선순위를 ‘수업 전 반드시 수정·수정 권장·그대로 사용 가능’으로 나누고 근거를 한 문장씩 써줘. 원본 파일은 변경하지 말고 분석만 해줘. 학생 이름이나 개인 기록이 나오면 결과에 포함하지 말아줘.
[5학년 과학] ‘[소화와 순환]’ 40분 수업 패키지를 만들어줘. 먼저 Drive에 ‘[5학년 과학/소화와 순환]’ 폴더를 만들고 아래 자료를 모두 그 안에 넣어줘.
1. 교수·학습 과정안: 초등 성취기준을 먼저 찾아 내가 고른 코드로 넣고, 도입 5분·활동 25분·정리 10분 과정표에 발문, 예상 오개념, 관찰 포인트
2. 학생용 학습지(학습지 양식): 이름 칸, 학습 목표, 활동 2개와 이름표 달린 답 칸, 자기 점검표
3. Google Slides 7장: 표지, 질문, 목표, 개념, 사례, 활동 안내, 정리
4. Google Forms 형성평가: 객관식 4문항과 단답형 1문항, 정답과 배점 포함
모든 자료에서 학습 목표와 용어를 동일하게 사용하고, 학생용 문장은 5학년 수준으로 짧게 써줘. 각 파일의 정보량과 읽기 흐름을 점검해줘. 마지막에는 ‘[5학년 3반 과학]’ Classroom 과제 초안에 학생용 학습지와 퀴즈만 첨부하고, 게시 전 수업·마감·배점·첨부를 내가 확인할 수 있게 보여줘. 승인하기 전에는 게시하지 마.
기존 자료를 읽는 예시는 --read 로그인이 필요합니다. Classroom 게시와 Drive 공유는 결과를 확인한 뒤 별도로 승인합니다.
작동 방식
Local-first privacy
프로젝트 운영자는 문서 내용이나 OAuth 토큰을 별도 중앙 서버에 수집·저장하지 않습니다. 사용자가 요청한 작업을 수행하기 위해 로컬 MCP가 Google API와 직접 통신합니다.
기존 자료와 학생 현황을 읽는 범위는 --read로 선택하며, 전체 Drive·Gmail·보호자 정보 범위는 요청하지 않습니다.
Open source
소스 코드, 요청 권한과 현재 지원 범위를 누구나 확인할 수 있습니다.
github.com/Kimmahone/edu-workspace-mcp →