14편 | 노션 API와 외부 서비스(구글 캘린더 등) 연동 기초 활용법

13편에서 페이지 공유와 권한 설정을 다뤘습니다. 이번에는 노션 밖으로 나가는 법을 다룹니다. 노션 API로 노션을 구글 캘린더 같은 외부 서비스와 연결하는 기초입니다. 노션 안에만 있던 할 일과 일정이 외부 서비스와 이어지면, 노션은 기록장이 아니라 허브가 됩니다. 오늘은 API가 무엇인지, 연동을 시작하는 순서, 구글 캘린더와 연결하는 세 가지 길, 처음 해볼 만한 작은 자동화까지 정리합니다.

1. 노션 API란 — 노션 밖에서 노션을 움직이는 통로

노션 API는 노션 데이터베이스와 페이지를 외부 프로그램에서 읽고 쓸 수 있게 해주는 공식 통로입니다. 개발자용이지만, 개념만 알면 비개발자도 자동화 도구를 통해 쓸 수 있습니다. API를 쓰면 할 일을 캘린더로 보내거나, 폼 응답을 데이터베이스에 쌓는 식의 연결이 됩니다. 핵심은 두 가지입니다. 노션 쪽에 이 외부 연결을 믿는다는 허락(통합)을 만들고, 그 허락에 딸린 열쇠(토큰)로 요청을 보내는 것입니다.

2. 연동 시작하기 — 통합 만들고 데이터베이스에 초대하기

연동은 노션 개발자 포털에서 연결(예전 이름은 통합)을 만드는 것부터 시작합니다. 2026년부터 개발자 포털이 노션 앱 안으로 들어와서, 노션의 설정 → 연결에서 ‘연결 개발 또는 관리’를 열거나 app.notion.com/developers/connections로 접속합니다. 예전 주소인 notion.so/my-integrations로 들어가도 이 화면으로 자동 이동합니다. ‘내부 연결’에서 새 연결을 만들고(워크스페이스 소유자만 만들 수 있습니다), 이름은 용도를 알 수 있게 정합니다. 예를 들어 “캘린더 연동”처럼 적습니다. 만들면 구성(Configuration) 탭에서 API 토큰이 발급됩니다. 이 토큰은 비밀번호와 같으니 다른 사람에게 보이지 않게 보관합니다. 다음으로 연결할 데이터베이스나 페이지를 열어 ••• 메뉴의 연결 추가에서 만든 연결을 초대합니다. 사람을 초대하는 것과 같은 방식입니다. 초대가 안 된 데이터베이스는 API로 열리지 않으니, 연결이 안 될 때는 초대 여부를 먼저 확인합니다.

3. API가 하는 일 — 검색, 조회, 만들기, 고치기

API로 할 수 있는 기본 동작은 네 가지입니다. 검색으로 페이지나 데이터베이스를 찾고, 데이터베이스를 조회해 행 목록을 가져오고, 페이지를 새로 만들고, 기존 페이지 내용을 고칩니다. 요청을 보낼 때는 버전 정보(Notion-Version 헤더)를 함께 보냅니다. 2026년 11월 기준 최신 버전은 2026-03-11입니다. 한 번에 너무 많은 요청을 보내면 제한에 걸리니, 요금제에 따라 달라지는 요청 제한을 확인하고 천천히 보내는 것이 좋습니다. 처음에는 조회만으로 시작해 읽기가 되는지 확인한 뒤에 쓰기를 더하는 순서가 안전합니다.

4. 구글 캘린더와 연결하는 세 가지 길

가장 쉬운 길은 노션 캘린더 앱입니다. 노션 캘린더는 구글 캘린더와 바로 연결돼, 구글 일정이 노션 캘린더 화면에 함께 보입니다. 노션에 적어 둔 일정과 구글 일정을 한 화면에서 볼 수 있습니다. 두 번째 길은 자동화 도구입니다. Zapier나 Make 같은 도구에서 “노션 데이터베이스에 새 행이 생기면 구글 캘린더에 일정을 만든다”는 흐름을 정하면, 코드를 쓰지 않고도 연결됩니다. 세 번째 길은 API를 직접 쓰는 것입니다. 노션 API로 마감일이 있는 행을 읽고, 구글 캘린더 API로 일정을 만드는 방식입니다. 손은 많이 가지만 원하는 대로 세밀하게 정할 수 있습니다. 처음이라면 노션 캘린더 앱부터, 반복되는 일을 줄이고 싶다면 자동화 도구부터 시작하는 것이 좋습니다.

5. 처음 해볼 만한 작은 자동화 — 마감일을 캘린더로 옮기기

예 하나를 정해 보겠습니다. 노션 할 일 데이터베이스에 마감일이 있는 행이 있습니다. 이 행이 생기거나 마감일이 바뀌면 구글 캘린더에 일정이 만들어집니다. 자동화 도구에서는 시작 조건을 “데이터베이스에 새 행 추가”로 정하고, 보낼 값을 제목과 마감일로 고릅니다. 캘린더 일정 제목에는 노션 행 제목을 그대로 넣고, 날짜는 마감일을 넣습니다. 이렇게 한 번만 흐름을 만들어 두면, 그 뒤로는 노션에 적는 것만으로 캘린더가 채워집니다. 반대로 캘린더 일정을 노션으로 가져오는 흐름도 같은 방식으로 만들 수 있습니다.

6. 연동할 때 조심할 것 — 열쇠 관리와 권한 범위

토큰은 비밀번호와 같습니다. 코드나 공유 문서에 그대로 적지 말고, 환경 변수나 비밀 저장소에 둡니다. 토큰이 새면 통합 설정에서 바로 폐기하고 새로 만듭니다. 두 번째로 권한 범위입니다. 통합은 초대한 데이터베이스와 페이지만 볼 수 있습니다. 워크스페이스 전체가 열리는 것이 아니니, 연결할 데이터베이스만 초대하는 것이 안전합니다. 마지막으로 동기화는 만능이 아닙니다. 양쪽을 동시에 고치면 어느 쪽이 최신인지 헷갈릴 수 있으니, 처음에는 한쪽 방향으로만 흐르게 정해 두는 것이 좋습니다. 잘 돌아가는 것을 확인한 뒤에 양방향으로 넓힙니다.

마무리

노션 API는 거창한 기술이 아닙니다. 통합을 만들고, 데이터베이스에 초대하고, 읽고 쓰는 요청을 보내는 순서가 전부입니다. 구글 캘린더와 이어 쓰면 노션에 적힌 할 일이 일정이 되고, 일정이 다시 노션 기록이 됩니다. 오늘은 노션 캘린더 앱부터 연결해 보고, 반복되는 일이 보이면 자동화 도구로 한 걸음만 더 나아가 보세요. 다음 편에서는 노션을 쓰며 초보자가 흔히 하는 실수 다섯 가지와 데이터를 안전하게 백업하는 법을 다룹니다.


노션 시리즈 모아보기

다음 편: 15편 — 노션 사용 시 초보자가 흔히 하는 실수 5가지와 데이터 백업 방법