meeting-notes

raw 회의록 md 파일을 Notion 팀스페이스 '회의록' 데이터베이스에 정리된 형식으로 등록하는 Claude Code 슬래시 커맨드 플러그인입니다.

개요

이 플러그인은 형식이 정해지지 않은 회의록 markdown 파일을 읽어 다음 두 가지 작업을 자동으로 수행합니다.

• 날짜, 참석자, 논의 내용, 결정 사항, 액션 아이템, 한줄 요약을 추출해 Notion '회의록' 데이터베이스에 정리된 페이지로 등록합니다.
• 추출된 액션 아이템이 있으면 담당자·기한과 함께 별도의 '액션 아이템' 데이터베이스에도 등록하고, 원본 회의록 페이지와 관계(relation)로 연결합니다.

사전 요구사항

이 플러그인을 사용하려면 아래 항목이 모두 준비되어 있어야 합니다.

1. Claude Code가 설치되어 있어야 합니다.
2. notion-team MCP 서버가 Claude Code에 연결되어 있어야 합니다.
3. Notion 워크스페이스에 아래 속성을 가진 '회의록' 데이터소스가 있으면 그대로 사용되고, 없으면 /meeting-notes-setup 실행 시 아래 스키마로 자동 생성됩니다.
   • 회의명 (제목)
   • 날짜 (날짜)
   • 상태 (선택)
   • 내용 (텍스트)
4. Notion 워크스페이스에 아래 속성을 가진 '액션 아이템' 데이터소스가 있으면 그대로 사용되고, 없으면 /meeting-notes-setup 실행 시 자동 생성됩니다.
   • 할 일 (제목)
   • 담당자 (사람)
   • 기한 (날짜)
   • 상태 (선택)
   • 원본 회의록 (관계)
5. 위 두 데이터베이스에 notion-team 커넥션(Connections) 권한이 부여되어 있어야 합니다. 권한이 없으면 커맨드 실행 시 등록에 실패합니다.

설치 방법

이 저장소를 Claude Code 플러그인 마켓플레이스로 추가한 뒤 플러그인을 설치합니다.

/plugin marketplace add <이 저장소의 경로 또는 URL>
/plugin install meeting-notes

설정 방법

1. config.example.json을 복사해 같은 위치에 config.json을 만듭니다.

   cp config.example.json config.json

2. /meeting-notes-setup을 실행합니다. Notion 연결 확인, '회의록'/'액션 아이템' 데이터소스 확보(검색 또는 자동 생성), 팀원 선택까지 안내에 따라 진행하면 config.json이 자동으로 채워집니다.

3. config.json은 .gitignore에 포함되어 있어 커밋되지 않습니다. /meeting-notes-setup을 실행하지 않아 값이 비어있으면, /meeting-notes 실행 시 안내 메시지만 뜨고 등록은 진행되지 않습니다.

사용법

/meeting-notes [raw 회의록 md 파일 경로]

예시:

/meeting-notes meeting-notes/2026-07-28.md

파일 경로를 생략하면 meeting-notes/ 디렉토리에 있는 파일 목록을 보여주고 어떤 파일을 등록할지 물어봅니다.

동작 과정

커맨드가 실행되면 아래 순서로 동작합니다.

1. 설정 확인: config.json의 notionDataSourceId, actionItemsDataSourceId, teamMembers를 읽습니다. 설정이 비어 있으면 안내 후 중단합니다.

2. 원본 파일 확인: 인자로 받은 경로의 md 파일을 읽습니다. 경로가 없으면 실제 오류를 그대로 보여주고 중단합니다.

3. 6개 항목 추출: 형식이 정해지지 않은 원문에서 아래 항목을 문맥상 판단으로 추출합니다. 원문에 없는 내용은 추측하지 않습니다.

   • 날짜 (원문 명시 → 파일명(YYYY-MM-DD.md) → 미기재 순으로 판단)
   • 참석자 (원문에 명시가 없으면 "미기재"가 아니라 teamMembers에 등록된 팀원 전원으로 채웁니다)
   • 논의 주제 및 세부 내용 (없으면 "미기재")
   • 결정 사항 (없으면 "미기재")
   • 액션 아이템 (담당자·할 일·기한을 각각 분리해서 추적합니다. 담당자가 특정 개인으로 명시되지 않으면 "전원"으로 남기고, 액션 아이템 자체가 없으면 "미기재")
   • 한줄 요약 (15~30자, 추출된 키워드만으로 구성)

   이 6개와 별개로 원문에 회의 소요 시간이나 시작/종료 시각이 언급되어 있으면 함께 추출합니다. 언급이 없으면 이 항목은 회의록 본문에서 생략됩니다.

4. 회의록 DB 등록: 회의명을 {날짜} 회의록 형식으로, 상태는 기본값 완료로 설정해 페이지를 생성합니다. 본문에는 참석자·(있으면) 소요 시간·원본 파일 경로·아젠다·논의 내용·결정 사항·액션 아이템이 고정된 템플릿으로 들어갑니다.

5. 액션 아이템 DB 등록: 추출된 액션 아이템이 있으면 항목별로 별도 페이지를 생성합니다. 담당자가 "전원"인 항목은 teamMembers에 등록된 모든 팀원을 담당자로 넣고, 특정 개인이 명시된 항목은 teamMembers에서 이름으로 조회해 매칭합니다. 상태는 기본값 진행 예정으로 설정하며, 원본 회의록은 4단계에서 생성된 페이지와 연결됩니다. 액션 아이템이 없으면 이 단계는 건너뜁니다.

6. 결과 보고: 등록 결과를 아래와 같은 메시지로 알려줍니다.

결과 메시지 예시

✅ Notion에 회의록을 등록했습니다: {페이지 링크}
📋 액션 아이템 3건을 '액션 아이템' DB에도 등록했습니다.
⚠️ 다음 담당자는 팀원 목록에 없어 액션 아이템 DB에 담당자 없이 등록됐습니다: 홍길동
config.json의 teamMembers를 확인해주세요.
⚠️ 다음 항목은 원본에서 찾지 못해 비워뒀습니다: 결정 사항
필요하면 Notion에서 직접 채워주세요.

주의사항

• 원본 md 파일은 읽기 전용으로만 사용되며 수정하거나 삭제하지 않습니다.
• 같은 파일로 커맨드를 다시 실행하면 Notion에 중복 페이지가 생성됩니다. 이미 등록했는지 확실하지 않으면 재실행 전에 확인이 필요합니다.
• 원문에 없는 내용은 절대 추측해서 채우지 않습니다. 참석자·액션 아이템 담당자처럼 팀 전체를 기본값으로 채우는 항목을 제외하면, 나머지는 "미기재"로 남깁니다.

트러블슈팅

Notion 등록 중 오류가 발생하면(권한 없음, 데이터베이스를 찾을 수 없음 등) 실제 오류 메시지와 함께 아래 안내가 표시됩니다.

데이터베이스에 notion-team 연결(Connections) 권한이 부여되어 있는지 확인해주세요.

이 경우 Notion 워크스페이스에서 '회의록'과 '액션 아이템' 데이터베이스에 notion-team 커넥션이 연결되어 있는지 먼저 확인해야 합니다.