Notion MCP Server

Notion bağlıyken ajan kod yazmadan önce gereksinim sayfasını okuyabilir, iş bitince görevin durumunu güncelleyip yorum bırakabilir. İki sunucu var: Notion'ın mcp.notion.com adresinde barındırdığı sunucu ve açık kaynak @notionhq/notion-mcp-server paketi. Notion barındırılan sunucuyu öneriyor ve yerel paketin artık aktif olarak bakımının yapılmadığını belirtiyor.

Kurulum

• Barındırılan: claude mcp add --transport http notion https://mcp.notion.com/mcp, ardından Claude Code'da /mcp çalıştırılıp OAuth akışı tamamlanır. Ajan, hesabınızın erişebildiği içeriğe ulaşır.
• Yerel: npx -y @notionhq/notion-mcp-server, NOTION_TOKEN değişkeninde dahili entegrasyon anahtarıyla (ntn_...). Yalnız entegrasyonla paylaşılan sayfalar görünür; sadece "Read content" yetkisi olan entegrasyon salt okunur çalışır.

Neler sunuyor

• Barındırılan: notion-search, notion-fetch, notion-create-pages, notion-update-page, notion-query-data-sources, notion-create-comment
• Yerel: Notion API'sinden türetilmiş araçlar; aralarında query-data-source, retrieve-page-markdown ve update-page-markdown var

Sınırlar

• Barındırılan sunucuda notion-search, standart API sınırlarına ek olarak dakikada 30 istekle sınırlı.
• Bazı arama filtreleri ve bağlı uygulamalarda AI araması çalışma alanının planına bağlı.
• Yerel sunucu veritabanı silemez; Notion yine de çalışma alanı verisinin tamamen risksiz olmadığını hatırlatıyor.

Süreci sabit bir entegrasyon anahtarıyla kendiniz çalıştırmanız gerekmiyorsa barındırılan sunucuyu seçin.