remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Notion's API to manage personal todo lists, providing functions to show all tasks, add new tasks, and update existing tasks in a Notion workspace.

개념-mcp

Notion API와 통합되어 개인 할 일 목록을 관리하는 간단한 MCP(Model Context Protocol) 서버입니다.

데모

시각적 가이드

Notion MCP 쿼리 1

Notion MCP 쿼리 2

Notion MCP 쿼리 3

필수 조건

Python 3.11 이상
API 액세스가 가능한 Notion 계정
Notion 통합 토큰
할 일 목록을 관리하려는 Notion 페이지
클로드 데스크탑 클린트

설정

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Notion MCP를 자동으로 설치하는 방법:

지엑스피1

저장소를 복제합니다.

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

Python 환경 설정:

uv venv
source .venv/bin/activate
uv pip install -e .

Notion 통합을 만듭니다.
- https://www.notion.so/my-integrations 로 이동하세요
- 새로운 통합을 만듭니다
- API 키를 복사하세요
통합을 통해 데이터베이스/페이지를 공유하세요:
- 데이터베이스/테이블이나 페이지가 있는 Notion 작업 공간을 엽니다.
- "..." 메뉴 → "연결 추가"를 클릭하세요.
- 통합을 선택하세요(이름으로 검색)

구성

.env 파일을 만듭니다.

cp .env.example .env

.env 에서 Notion 자격 증명을 구성합니다.

NOTION_TOKEN=<your-notion-api-token>
PAGE_ID=<your-notion-page-id>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

Claude Desktop에서 원하는 대로 사용하려면 claude_desktop_config.json 파일을 수정해야 합니다. Claude Desktop -> Settings -> Developer -> Edit Config 으로 이동하세요. 이제 Notion 서버 구성을 추가하세요.

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */,
                "run",
                "server.py"
            ]
        }
    }
}

개발

프로젝트 구조:

notion-mcp/
├── docs/
├── src/
│ └── server.py
├── .env
├── .python-version
├── README.md
├── pyproject.toml
└── uv.lock

지원 기능

작업 표시

Notion 작업 공간에서 모든 작업을 표시하려면 show_all_todos 함수를 사용하세요.

{
    "name": "show_all_todos",
    "arguments": {}
}

작업 추가

Notion 작업 공간에 새 작업을 추가하려면 add_todo 함수를 사용하세요.

{
    "name": "add_todo",
    "arguments": {
        "task": "Your task description"
    }
}

업데이트 작업

Notion 작업 공간에서 기존 작업을 업데이트하려면 complete_todo 함수를 사용하세요.

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "your-task-id"
    }
}

기여하다

저장소를 포크하세요
기능 브랜치 생성
풀 리퀘스트 제출

특허

MIT 라이선스. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

개인 할 일 목록을 관리하기 위해 Notion의 API와 통합된 모델 컨텍스트 프로토콜 서버로, 사용자는 Claude에서 직접 작업을 보고, 추가하고, 업데이트할 수 있습니다.

Related Resources

Reddit Discussion about this server