Agenda 자동화하기

Agenda를 자동화해 강력한 워크플로를 만들 수 있습니다. 예를 들어 Siri 단축어나 단축어 앱을 사용하는 상위 수준 방식으로도, x-callback-url 지원 같은 하위 수준 방식으로도 가능합니다. 가능성은 무궁무진합니다!

앱 단축어

Agenda 15부터 앱 단축어는 단축어 앱을 통해 Agenda에서 하나 이상의 작업을 빠르게 처리하는 방법입니다. 여러 Agenda 단축어를 조합하고, 원한다면 다른 앱의 단축어와도 결합해 워크플로를 만들고 자동화할 수 있습니다. iPad 홈 화면에서 특정 노트를 여는 간단한 일부터, 휴대폰 뒷면을 두 번 두드려 새 노트를 실행하는 것, 나아가 여러 앱에서 오늘 해야 할 일을 모두 가져와 한 번의 탭으로 새 프로젝트를 만드는 복잡한 워크플로까지 가능합니다.

iOS용 Agenda는 특정 노트, 프로젝트, 훑어보기를 여는 것 같은 흔한 동작에 대해 Siri 단축어도 지원합니다.

단축어에서 노트 검색

단축어 앱의 노트 검색 동작을 사용해 특정 조건에 맞는 노트를 찾을 수 있습니다. 이는 x-callback-url을 통해서도 이용할 수 있습니다. 검색 질의는 \color, \done, \pinned 등의 액션 문법을 지원하므로, 자동화에서도 앱 내 검색과 동일한 힘을 발휘할 수 있습니다.

Siri

Siri를 사용해 노트를 검색하고 Agenda와 상호작용할 수 있습니다. 예를 들어 Siri에게 Agenda에서 무언가를 검색해 달라고 요청하면 결과를 바로 미리 볼 수 있습니다. Siri는 Agenda와 다른 앱 사이의 더 풍부한 데이터 교환도 지원합니다.

제어 센터

iOS에서 Agenda는 앱을 먼저 열지 않고도 오늘 또는 Agenda 톺아보기 훑어보기로 빠르게 이동할 수 있는 제어 센터 버튼을 제공합니다. 기기의 제어 센터 설정에서 이 버튼을 추가할 수 있습니다.

x-callback-url 지원

Agenda는 x-callback url도 지원합니다. 이를 통해 앱 사이의 워크플로를 연결하거나 Agenda 내의 특정 동작을 자동화할 수 있습니다. Apple의 단축어 앱에서도 지원됩니다.

x-callback-url 간단 소개:

URL 스킴은 agenda 또는 agenda-notes 입니다
현재 명령에는 on-the-agenda, today, open-project 등이 있습니다
“open-project"와 “open-note"의 경우 title 파라미터로 대상을 지정할 수 있습니다.
평소와 같이 선택적인 x-success 및 x-error 파라미터로 콜백 URL을 제공할 수 있습니다.

예를 들어 “Meeting With Peta"라는 노트로 Agenda를 열려면 다음 URL을 사용할 수 있습니다. agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Agenda 23의 새 기능: move-note 동작을 사용하면 다른 앱이나 단축어에서 프로젝트 간에 노트를 옮길 수 있습니다. agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP(Model Context Protocol) 통합

Agenda에는 macOS용 내장 MCP 서버가 포함되어 있어, AI 어시스턴트가 노트, 프로젝트, 카테고리와 상호작용할 수 있습니다. MCP는 Claude Code, Claude Desktop, Cursor, Codex 같은 도구가 앱과 통신하는 데 사용하는 개방형 프로토콜입니다.

MCP 서버 켜기

MCP 서버는 기본적으로 꺼져 있습니다. 켜려면 Agenda* 메뉴로 가서 통합 > *MCP 활성화 를 선택하세요. 서버는 Mac에서 로컬로 http://127.0.0.1:16106/mcp 에서 실행되며, 사용자 본인의 컴퓨터에서만 접근할 수 있습니다.

통합 메뉴에서는 다양한 AI 도구를 연결하기 위한 구성 명령을 복사하는 옵션과, 바로 다운로드해 설치할 수 있는 Claude Desktop 플러그인도 제공합니다.

사용 가능한 도구

MCP 서버는 AI 어시스턴트가 사용할 수 있는 다음 도구를 제공합니다.

search_notes — 텍스트, 태그, 날짜 및 기타 조건으로 노트를 검색합니다
get_note — 특정 노트의 전체 내용을 가져옵니다
list_projects — 모든 프로젝트를 나열하며, 원하면 아카이브된 것도 포함합니다
list_categories — 모든 카테고리를 나열합니다
open_note — Agenda에서 특정 노트를 엽니다
create_note — 프로젝트에 새 노트를 만들며, 선택적으로 파일을 첨부합니다
append_to_note — 기존 노트에 내용 및/또는 파일 첨부를 추가합니다
edit_note — 기존 노트의 내용을 수정하며, 선택적으로 파일을 첨부합니다
create_project — 새 프로젝트를 만듭니다
create_category — 새 카테고리를 만듭니다
move_note — 기존 노트를 다른 프로젝트로 옮깁니다 (Agenda 23의 새 기능)

AI 도구 연결하기

AI 도구를 Agenda의 MCP 서버에 연결하려면 통합 메뉴의 구성 명령을 사용하거나 직접 설정하세요.

Claude Code:

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor: MCP 구성에서 명령으로 npx mcp-remote http://localhost:16106/mcp 를 사용하세요. 또는 통합 메뉴에서 Claude Desktop 플러그인을 바로 설치하세요.

Codex: ~/.codex/config.toml 에 다음을 추가하세요.

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

첨부 파일

create_note, append_to_note, edit_note 도구는 노트에 파일 첨부를 추가하는 것을 지원합니다. 첨부 파일은 base64로 인코딩된 데이터로 전송되므로, AI 어시스턴트가 Mac에서 파일을 읽고 인코딩해 노트에 첨부하는 일을 한 번에 처리할 수 있습니다. 예를 들어 AI 어시스턴트에게 “이 PDF를 내 회의 노트에 첨부해 줘"라고 요청하면 나머지는 알아서 처리합니다.

각 첨부 파일에는 filename(Agenda가 파일 형식을 알 수 있도록 확장자 포함)과 base64로 인코딩된 파일 data 가 필요합니다. 선택적으로 displayStyle(inline, thumbnail, thumbnail-with-details, full-width)과 displaySize(small, medium, large)로 첨부 파일이 표시되는 방식을 지정할 수 있습니다.

제한: 요청당 최대 20개의 첨부 파일, 파일 데이터 총 최대 100MB.

도움말 리소스

MCP 서버는 Agenda 문서의 흔한 주제를 다루는 도움말 리소스도 제공하므로, AI 어시스턴트가 기능의 작동 방식을 찾아보고 Agenda에 대해 더 나은 답변을 줄 수 있습니다.

무엇을 요청할 수 있나요

AI 도구를 연결하고 나면 요청에 따라 노트를 읽고 수정할 수 있습니다. 잘 작동하는 예를 몇 가지 들면 다음과 같습니다.

“이번 주 회의 노트를 요약해서 Weekly Reviews 프로젝트에 새 노트로 만들어 줘.”
"#followup 태그가 붙어 있으면서 Anna를 언급한 것을 모두 찾아서 나열해 줘.”
“이 PDF의 실행 항목을 내 Project Kickoff 노트 맨 아래에 추가해 줘.” (AI가 파일도 첨부할 수 있습니다)
"‘Q2 Planning’ 노트를 Drafts에서 Strategy 프로젝트로 옮겨 줘.”
“Holiday라는 새 프로젝트를 만들고 짐 목록으로 채워 줘.”

MCP 서버는 Mac에서 로컬로 실행되므로, AI 도구로 가는 도중에 노트가 컴퓨터를 떠나는 일은 없습니다. 어시스턴트가 읽거나 쓰는 특정 텍스트만 그곳을 거쳐 전송됩니다.

문제 해결

AI 도구가 Agenda를 인식하지 못한다면:

MCP가 켜져 있나요? Agenda > 통합 > MCP 활성화* 를 확인하세요. 서버가 실행 중이면 메뉴 항목이 *MCP 비활성화 로 바뀝니다.
Agenda가 실행 중인가요? 서버는 Agenda 앱 안에 있습니다. Agenda를 종료하면 서버도 함께 멈춥니다.
MCP를 켠 뒤에 AI 도구가 다시 연결되었나요? 일부 클라이언트는 실행 시점에 연결을 캐시합니다. MCP를 켜기 전에 AI 도구가 실행 중이었다면 다시 시작하세요.
포트 16106이 다른 프로그램에 사용되고 있나요? 터미널에서 간단히 확인해 보세요. curl http://127.0.0.1:16106/mcp 를 실행하면 (“connection refused"가 아니라) 응답이 돌아와야 합니다.

참고: MCP 서버는 macOS에서만 사용할 수 있습니다.