Notion

ADK에서 지원PythonTypeScriptGo

Notion MCP 서버는 ADK 에이전트를 Notion에 연결하여 작업 공간 내에서 페이지, 데이터베이스 등을 검색, 생성 및 관리할 수 있도록 합니다. 이를 통해 에이전트는 자연어를 사용하여 Notion 작업 공간의 콘텐츠를 쿼리, 생성 및 구성할 수 있습니다.

사용 사례

• 작업 공간 검색: 콘텐츠를 기반으로 프로젝트 페이지, 회의록 또는 문서를 찾습니다.

• 새 콘텐츠 만들기: 회의록, 프로젝트 계획 또는 작업에 대한 새 페이지를 생성합니다.

• 작업 및 데이터베이스 관리: 작업 상태를 업데이트하거나, 데이터베이스에 항목을 추가하거나, 속성을 변경합니다.

• 작업 공간 구성: 페이지를 이동하거나, 템플릿을 복제하거나, 문서에 댓글을 추가합니다.

전제 조건

• 프로필의 Notion 통합으로 이동하여 Notion 통합 토큰을 얻습니다. 자세한 내용은 인증 설명서를 참고하세요.
• 관련 페이지 및 데이터베이스에 통합이 액세스할 수 있는지 확인합니다. Notion 통합 설정의 액세스 탭을 방문한 다음 사용하려는 페이지를 선택하여 액세스 권한을 부여합니다.

에이전트와 함께 사용

PythonTypeScriptGo

로컬 MCP 서버

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

NOTION_TOKEN = "YOUR_NOTION_TOKEN"

root_agent = Agent(
    model="gemini-flash-latest",
    name="notion_agent",
    instruction="Help users get information from Notion",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "@notionhq/notion-mcp-server",
                    ],
                    env={
                        "NOTION_TOKEN": NOTION_TOKEN,
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

로컬 MCP 서버

import { LlmAgent, MCPToolset } from "@google/adk";

const NOTION_TOKEN = "YOUR_NOTION_TOKEN";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "notion_agent",
    instruction: "Help users get information from Notion",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: ["-y", "@notionhq/notion-mcp-server"],
                env: {
                    NOTION_TOKEN: NOTION_TOKEN,
                },
            },
        }),
    ],
});

export { rootAgent };

로컬 MCP 서버

package main

import (
    "context"
    "log"
    "os"
    "os/exec"

    "github.com/modelcontextprotocol/go-sdk/mcp"
    "google.golang.org/genai"

    "google.golang.org/adk/v2/agent"
    "google.golang.org/adk/v2/agent/llmagent"
    "google.golang.org/adk/v2/cmd/launcher"
    "google.golang.org/adk/v2/cmd/launcher/full"
    "google.golang.org/adk/v2/model/gemini"
    "google.golang.org/adk/v2/tool"
    "google.golang.org/adk/v2/tool/mcptoolset"
)

const notionToken = "YOUR_NOTION_TOKEN"

func main() {
    ctx := context.Background()

    model, err := gemini.NewModel(ctx, "gemini-flash-latest", &genai.ClientConfig{
        APIKey: os.Getenv("GOOGLE_API_KEY"),
    })
    if err != nil {
        log.Fatalf("Failed to create the model: %v", err)
    }

    server := exec.CommandContext(ctx, "npx", "-y", "@notionhq/notion-mcp-server")
    // Forward only what npx needs, plus the Notion token. The parent environment
    // may hold unrelated secrets, such as the GOOGLE_API_KEY read above.
    server.Env = []string{"NOTION_TOKEN=" + notionToken}
    for _, k := range []string{
        "PATH", "HOME", // POSIX
        "APPDATA", "LOCALAPPDATA", "TEMP", "USERPROFILE", // Windows
    } {
        if v, ok := os.LookupEnv(k); ok {
            server.Env = append(server.Env, k+"="+v)
        }
    }

    notion, err := mcptoolset.New(mcptoolset.Config{
        Transport: &mcp.CommandTransport{Command: server},
    })
    if err != nil {
        log.Fatalf("Failed to create the Notion tool set: %v", err)
    }

    rootAgent, err := llmagent.New(llmagent.Config{
        Model:       model,
        Name:        "notion_agent",
        Instruction: "Help users get information from Notion",
        Toolsets:    []tool.Toolset{notion},
    })
    if err != nil {
        log.Fatalf("Failed to create the agent: %v", err)
    }

    l := full.NewLauncher()
    cfg := &launcher.Config{AgentLoader: agent.NewSingleLoader(rootAgent)}
    if err := l.Execute(ctx, cfg, os.Args[1:]); err != nil {
        log.Fatalf("Run failed: %v\n\n%s", err, l.CommandLineSyntax())
    }
}

사용 가능한 도구

도구	설명
notion-search	Notion 작업 공간 및 Slack, Google Drive, Jira와 같은 연결된 도구에서 검색합니다. AI 기능을 사용할 수 없는 경우 기본 작업 공간 검색으로 대체됩니다.
notion-fetch	URL로 Notion 페이지 또는 데이터베이스에서 콘텐츠를 검색합니다.
notion-create-pages	지정된 속성 및 콘텐츠로 하나 이상의 Notion 페이지를 만듭니다.
notion-update-page	Notion 페이지의 속성 또는 콘텐츠를 업데이트합니다.
notion-move-pages	하나 이상의 Notion 페이지 또는 데이터베이스를 새 상위 항목으로 이동합니다.
notion-duplicate-page	작업 공간 내에서 Notion 페이지를 복제합니다. 이 작업은 비동기적으로 완료됩니다.
notion-create-database	지정된 속성으로 새 Notion 데이터베이스, 초기 데이터 원본 및 초기 보기를 만듭니다.
notion-update-database	Notion 데이터 원본의 속성, 이름, 설명 또는 기타 특성을 업데이트합니다.
notion-create-comment	페이지에 댓글 추가
notion-get-comments	스레드 토론을 포함하여 특정 페이지의 모든 댓글을 나열합니다.
notion-get-teams	현재 작업 공간의 팀(팀스페이스) 목록을 검색합니다.
notion-get-users	작업 공간의 모든 사용자를 세부 정보와 함께 나열합니다.
notion-get-user	ID로 사용자 정보 검색
notion-get-self	자신의 봇 사용자와 연결된 Notion 작업 공간에 대한 정보를 검색합니다.

추가 리소스

• Notion MCP 서버 설명서
• Notion MCP 서버 리포지토리