Which integrations are available for this server?

Read-only access to Notion data via local SQLite cache, enabling fast retrieval of pages, databases, users, and workspace information without API calls.

How do I use notion-mcp-fast?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@notion-mcp-fast list my recent pages" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

notion-mcp-fast

by lucid-jin

Overview Schema Source Related Servers Discussions Admin

Python

Local

notion-mcp-fast

English | 한국어

Fast, read-only MCP server for Notion - reads directly from local SQLite cache, no API calls needed.

Why?

The official Notion MCP makes API calls for every read operation:

Slow: Network latency on every request
Rate limited: API quotas apply
Context heavy: Verbose responses consume AI context window

notion-mcp-fast reads directly from Notion's local SQLite cache:

Instant: No network calls, <10ms response times
Unlimited: No API rate limits
Minimal: Clean, concise responses

Related MCP server: notion-full-mcp

Requirements

macOS only (Notion stores SQLite cache at a macOS-specific path)
Notion desktop app installed and logged in
Python 3.10+

Installation

git clone https://github.com/lucid-jin/notion-mcp-fast.git
cd notion-mcp-fast

Setup

Claude Code

# Add MCP server (use absolute path)
claude mcp add notion-fast -- uvx --from /path/to/notion-mcp-fast notion-mcp-fast

# Example with home directory
claude mcp add notion-fast -- uvx --from ~/notion-mcp-fast notion-mcp-fast

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notion-fast": {
      "command": "uvx",
      "args": ["--from", "/path/to/notion-mcp-fast", "notion-mcp-fast"]
    }
  }
}

Recommended: Use with Official Notion MCP

For a complete setup, use both:

notion-fast: Fast reads from local cache
Official Notion MCP: Writes and real-time data

{
  "mcpServers": {
    "notion-fast": {
      "command": "uvx",
      "args": ["notion-mcp-fast"]
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Tool	Description
`list_pages`	List pages with optional search and filtering
`get_page`	Get a page with its child blocks
`list_databases`	List all databases (collections)
`get_database`	Get database schema and details
`query_database`	Query rows from a database
`list_users`	List all users
`get_user`	Get user details
`list_spaces`	List all workspaces
`search`	Search across all pages by title
`get_summary`	Get counts of all cached entities

How It Works

┌─────────────────────────────────────┐
│         Notion Desktop App          │
│                                     │
│   Syncs data → SQLite database      │
└─────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────┐
│  ~/Library/Application Support/     │
│  Notion/notion.db                   │
│                                     │
│  SQLite with 162K+ blocks           │
└─────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────┐
│        notion-mcp-fast              │
│                                     │
│  • Reads SQLite directly            │
│  • 5-minute TTL cache               │
│  • MCP protocol interface           │
└─────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────┐
│     Claude / AI Assistant           │
│                                     │
│  Instant access to Notion data!     │
└─────────────────────────────────────┘

Limitations

Read-only: Cannot create or modify Notion content
macOS only: SQLite path is macOS-specific
Cache lag: Data reflects last Notion app sync (usually <1 min)
Requires Notion app: Desktop app must be installed and logged in

Troubleshooting

"Notion database not found"

Ensure Notion desktop app is installed
Open Notion app and let it sync
Check if file exists: ls ~/Library/Application\ Support/Notion/notion.db

Stale data

Notion caches data locally with frequent syncs. If data seems stale:

Open Notion app
Navigate to the page/database
Wait a few seconds for sync
Re-query via MCP

License

MIT

Inspired By

linear-mcp-fast - Same concept for Linear

한국어

Notion용 초고속 읽기 전용 MCP 서버 - API 호출 없이 로컬 SQLite 캐시에서 직접 읽습니다.

왜 만들었나요?

공식 Notion MCP는 매번 API를 호출합니다:

느림: 매 요청마다 네트워크 지연
제한: API 호출 제한 적용
무거움: 응답이 커서 AI 컨텍스트 윈도우 소모

notion-mcp-fast는 로컬 SQLite 캐시에서 직접 읽습니다:

즉시 응답: 네트워크 호출 없음, <10ms 응답
무제한: API 제한 없음
가벼움: 깔끔하고 간결한 응답

요구사항

macOS 전용 (Notion이 macOS 특정 경로에 SQLite 캐시 저장)
Notion 데스크톱 앱 설치 및 로그인 필요
Python 3.10+

설치

git clone https://github.com/lucid-jin/notion-mcp-fast.git
cd notion-mcp-fast

설정

Claude Code

# MCP 서버 추가 (절대 경로 사용)
claude mcp add notion-fast -- uvx --from /path/to/notion-mcp-fast notion-mcp-fast

# 홈 디렉토리 예시
claude mcp add notion-fast -- uvx --from ~/notion-mcp-fast notion-mcp-fast

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json 편집:

{
  "mcpServers": {
    "notion-fast": {
      "command": "uvx",
      "args": ["--from", "/path/to/notion-mcp-fast", "notion-mcp-fast"]
    }
  }
}

제공 도구

도구	설명
`list_pages`	페이지 목록 (검색/필터 지원)
`get_page`	페이지 상세 + 하위 블록
`list_databases`	데이터베이스 목록
`get_database`	데이터베이스 스키마 조회
`query_database`	데이터베이스 행 조회
`list_users`	사용자 목록
`get_user`	사용자 상세
`list_spaces`	워크스페이스 목록
`search`	제목으로 전체 검색
`get_summary`	캐시 통계

작동 원리

Notion 데스크톱 앱
    ↓ (로컬 동기화)
~/Library/Application Support/Notion/notion.db (SQLite)
    ↓ (직접 읽기)
notion-mcp-fast (5분 TTL 캐시)
    ↓ (MCP 프로토콜)
Claude / AI 어시스턴트 → 즉시 응답!

성능

상황	응답 시간
Cold cache (첫 요청)	~5초
Warm cache (이후 요청)	<1ms

제한사항

읽기 전용: Notion 콘텐츠 생성/수정 불가
macOS 전용: SQLite 경로가 macOS 고정
캐시 지연: Notion 앱 동기화 후 반영 (보통 <1분)
앱 필요: Notion 데스크톱 앱 설치 필수

문제 해결

"Notion database not found" 오류

Notion 데스크톱 앱 설치 확인
Notion 앱 열고 동기화 대기
파일 존재 확인: ls ~/Library/Application\ Support/Notion/notion.db

데이터가 오래됨

Notion 앱 열기
해당 페이지/데이터베이스로 이동
몇 초 대기 (동기화)
MCP로 다시 조회

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

remnus AOAuth
io.github.Ranork
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Note Taking Project Management Workplace & Productivity
25373
The Quiet Protocol Growth Offense MCP A
com.thequietprotocol.www
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Databases Research & Data Finance
292
saagarpatel.dev Portfolio A
io.github.saagpatel
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Search Documentation Access
82
classquill-mcp
io.github.EquateItAu
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Education & Learning Tools CRM
2

Related MCP Servers

tiny-notion-mcp
Note Taking Knowledge & Memory
AyanoT1
A
license
A
quality
C
maintenance
A lightweight Notion MCP server that minimizes token usage by returning Markdown instead of raw JSON, enabling efficient read/write operations on Notion pages.
Updated 4 months ago (2026-05-08 02:12 UTC)
9
MIT
notion-full-mcp
Note Taking Workplace & Productivity
cphoskins
A
license
A
quality
B
maintenance
Full-featured Notion MCP server enabling deep page reading, block editing, snapshot/restore, file uploads, table manipulation, page restore, and destructive page copying.
Updated 5 months ago (2026-04-09 02:22 UTC)
33
MIT
notion-private-api-mcp
Note Taking Knowledge & Memory
kirvigen
A
license
A
quality
C
maintenance
Unofficial Notion MCP server built on Notion's private API (token_v2 cookie). Gives LLM agents full read/write access to the entire workspace — no integration token and no per-page sharing.
Updated 3 months ago (2026-06-01 08:25 UTC)
11
9 npm
4
MIT
nooon
Note Taking Knowledge & Memory Search
corrupt952
A
license
Not graded
quality
A
maintenance
A lightweight, read-only MCP server for Notion that enables searching, reading pages, and querying databases with token-efficient output and smart caching.
Updated 9 days ago (2026-09-06 17:58 UTC)
25 npm
5
MIT

notion-mcp-fast

Why?

Requirements

Installation

Setup

Claude Code

Claude Desktop

Recommended: Use with Official Notion MCP

Available Tools

How It Works

Limitations

Troubleshooting

"Notion database not found"

Stale data

License

Inspired By

한국어

왜 만들었나요?

요구사항

설치

설정

Claude Code

Claude Desktop

제공 도구

작동 원리

성능

제한사항

문제 해결

"Notion database not found" 오류

데이터가 오래됨

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

tiny-notion-mcp

notion-full-mcp

notion-private-api-mcp

nooon