Notion MCP

npx add-mcp 'https://mcp.notion.com/mcp'

Notion MCP सर्वर

[!NOTE]

सर्वोत्तम अनुभव के लिए, रिमोट Notion MCP का उपयोग करें, जो हमारा आधिकारिक होस्टेड MCP सर्वर है। यह रिपॉजिटरी एक अलग, स्व-होस्टेड MCP सर्वर कार्यान्वयन है जिसे अब सक्रिय रूप से अनुरक्षित या समर्थित नहीं किया जाता है। कृपया इसके बजाय रिमोट Notion MCP का उपयोग करें। इसे विशेष रूप से AI एजेंटों को बहुत कम टोकन का उपयोग करके तेज़ परिणाम देने के लिए बनाया गया है।

रिमोट Notion MCP आपके वर्कस्पेस और कनेक्टेड ऐप्स को सिमेंटिक रूप से खोज सकता है, पेजों को मार्कडाउन में पढ़ और संपादित कर सकता है, और केवल सबसे प्रासंगिक संदर्भ लौटा सकता है। इसका मतलब है कम प्रतीक्षा समय, कम संदर्भ-विंडो उपयोग, और कम टोकन लागत। यह OAuth का भी उपयोग करता है और स्वचालित रूप से प्रत्येक उपयोगकर्ता की मौजूदा Notion अनुमतियों का सम्मान करता है—बिना API टोकन, JSON कॉन्फ़िगरेशन, मैन्युअल पेज साझाकरण, या स्थानीय सर्वर के रखरखाव के।

सुविधा	रिमोट Notion MCP	यह प्रोजेक्ट (स्थानीय)
तेज़, होस्टेड अनुभव	✅	स्थानीय रूप से चलता और अपडेट होता है
टोकन-कुशल प्रतिक्रियाएँ	✅	सीमित
AI एजेंटों के लिए अनुकूलित शक्तिशाली उपकरण	✅	बुनियादी API-व्युत्पन्न उपकरण
आपके Notion वर्कस्पेस में सिमेंटिक खोज	✅	केवल कीवर्ड खोज
कनेक्टेड ऐप्स में AI कनेक्टर खोज	✅	उपलब्ध नहीं
मार्कडाउन-मूल पेज पढ़ना और संपादन	✅	दो पेज-सामग्री उपकरणों तक सीमित
सहज OAuth सेटअप	✅	मैन्युअल टोकन और JSON कॉन्फ़िगरेशन
प्रत्येक उपयोगकर्ता की मौजूदा Notion अनुमतियों का सम्मान करता है	✅	मैन्युअल एकीकरण अनुमतियाँ और पेज साझाकरण
सक्रिय समर्थन और निरंतर सुधार	✅	सक्रिय रूप से समर्थित नहीं

अधिक जानें और रिमोट Notion MCP दस्तावेज़ीकरण में आरंभ करें।

हम रिमोट Notion MCP को प्राथमिकता दे रहे हैं, और केवल इसके लिए सक्रिय समर्थन प्रदान कर रहे हैं। परिणामस्वरूप:

• हम भविष्य में इस स्थानीय MCP सर्वर रिपॉजिटरी को बंद कर सकते हैं।
• यहाँ मुद्दों और पुल अनुरोधों की सक्रिय रूप से निगरानी नहीं की जाती है।
• कृपया रिमोट MCP से संबंधित मुद्दे यहाँ दर्ज न करें; इसके बजाय Notion समर्थन से संपर्क करें।

यह प्रोजेक्ट Notion API के लिए एक MCP सर्वर लागू करता है।

---

⚠️ संस्करण 2.0.0 ब्रेकिंग परिवर्तन

संस्करण 2.0.0 Notion API 2025-09-03 में स्थानांतरित होता है जो डेटा स्रोतों को डेटाबेस के लिए प्राथमिक अमूर्तता के रूप में पेश करता है।

क्या बदला

हटाए गए उपकरण (3):

• post-database-query - query-data-source द्वारा प्रतिस्थापित
• update-a-database - update-a-data-source द्वारा प्रतिस्थापित
• create-a-database - create-a-data-source द्वारा प्रतिस्थापित

नए उपकरण (7):

• query-data-source - फ़िल्टर और सॉर्ट के साथ डेटा स्रोत (डेटाबेस) क्वेरी करें
• retrieve-a-data-source - डेटा स्रोत के लिए मेटाडेटा और स्कीमा प्राप्त करें
• update-a-data-source - डेटा स्रोत गुण अपडेट करें
• create-a-data-source - एक नया डेटा स्रोत बनाएं
• list-data-source-templates - डेटा स्रोत में उपलब्ध टेम्पलेट सूचीबद्ध करें
• move-page - किसी पेज को विभिन्न पैरेंट स्थान पर ले जाएं
• retrieve-a-database - इसके डेटा स्रोत आईडी सहित डेटाबेस मेटाडेटा प्राप्त करें

पैरामीटर परिवर्तन:

• सभी डेटाबेस संचालन अब database_id के बजाय data_source_id का उपयोग करते हैं
• खोज फ़िल्टर मान ["page", "database"] से ["page", "data_source"] में बदल गए
• पेज निर्माण अब page_id और database_id दोनों पैरेंट का समर्थन करता है (डेटा स्रोतों के लिए)

क्या मुझे स्थानांतरित करने की आवश्यकता है?

कोई कोड परिवर्तन आवश्यक नहीं है। सर्वर शुरू होने पर MCP उपकरण स्वचालित रूप से खोजे जाते हैं। जब आप v2.0.0 में अपग्रेड करते हैं, तो AI क्लाइंट स्वचालित रूप से नए उपकरण नाम और पैरामीटर देखेंगे। पुराने डेटाबेस उपकरण अब उपलब्ध नहीं हैं।

यदि आपके पास हार्डकोडेड उपकरण नाम या प्रॉम्प्ट हैं जो पुराने डेटाबेस उपकरणों को संदर्भित करते हैं, तो उन्हें नए डेटा स्रोत उपकरणों का उपयोग करने के लिए अपडेट करें:

पुराना उपकरण (v1.x)	नया उपकरण (v2.0)	पैरामीटर परिवर्तन
post-database-query	query-data-source	database_id → data_source_id
update-a-database	update-a-data-source	database_id → data_source_id
create-a-database	create-a-data-source	कोई परिवर्तन नहीं (parent.page_id का उपयोग करता है)

नोट: retrieve-a-database अभी भी उपलब्ध है और डेटा स्रोत आईडी की सूची सहित डेटाबेस मेटाडेटा लौटाता है। किसी विशिष्ट डेटा स्रोत की स्कीमा और गुण प्राप्त करने के लिए retrieve-a-data-source का उपयोग करें।

कुल उपकरण अब: 22 (v1.x में 19 थे)

---

पेज सामग्री मार्कडाउन के रूप में

सर्वर ब्लॉक JSON के बजाय उन्नत मार्कडाउन के रूप में पेज सामग्री के साथ काम करने के लिए दो उपकरण प्रदान करता है, जो AI एजेंटों के लिए काफी अधिक टोकन-कुशल है:

• retrieve-page-markdown — किसी पेज की पूरी सामग्री मार्कडाउन के रूप में पढ़ें (GET /v1/pages/{page_id}/markdown)। मीटिंग-नोट ट्रांसक्रिप्ट इनलाइन करने के लिए include_transcript: true पास करें।
• update-page-markdown — मार्कडाउन के साथ पेज की सामग्री संपादित करें (PATCH /v1/pages/{page_id}/markdown)। पूरे पेज को अधिलेखित करने के लिए replace_content पसंद करें, या लक्षित खोज-और-प्रतिस्थापन संपादनों के लिए update_content।

इन एंडपॉइंट्स के लिए Notion API संस्करण 2026-03-11 की आवश्यकता होती है। सर्वर अब OpenAPI स्पेक से Notion-Version हेडर को प्रति संचालन स्रोत करता है, इसलिए ये उपकरण 2026-03-11 का उपयोग करते हैं जबकि बाकी API 2025-09-03 का उपयोग जारी रखता है — कोई कॉन्फ़िगरेशन आवश्यक नहीं है। यदि आप OPENAPI_MCP_HEADERS के माध्यम से स्वयं Notion-Version सेट करते हैं, तो आपका मान प्रत्येक उपकरण के लिए प्राथमिकता लेता है।

---

स्थापना

1. Notion में एकीकरण सेट करना

https://www.notion.so/profile/integrations पर जाएं और एक नया आंतरिक एकीकरण बनाएं या मौजूदा एक का चयन करें।

जबकि हम Notion API के उजागर दायरे को सीमित करते हैं (उदाहरण के लिए, आप MCP के माध्यम से डेटाबेस हटाने में सक्षम नहीं होंगे), इसे LLM के लिए उजागर करके वर्कस्पेस डेटा के लिए गैर-शून्य जोखिम है। सुरक्षा-जागरूक उपयोगकर्ता एकीकरण की क्षमताओं को और कॉन्फ़िगर करना चाह सकते हैं।

उदाहरण के लिए, आप "कॉन्फ़िगरेशन" टैब से केवल "सामग्री पढ़ें" एक्सेस देकर एक केवल-पढ़ने वाला एकीकरण टोकन बना सकते हैं:

2. एकीकरण से सामग्री कनेक्ट करना

सुनिश्चित करें कि प्रासंगिक पेज और डेटाबेस आपके एकीकरण से जुड़े हैं।

ऐसा करने के लिए, अपनी आंतरिक एकीकरण सेटिंग्स में एक्सेस टैब पर जाएं। एक्सेस संपादित करें और उन पेजों का चयन करें जिन्हें आप उपयोग करना चाहते हैं।

वैकल्पिक रूप से, आप व्यक्तिगत रूप से पेज एक्सेस दे सकते हैं। आपको लक्ष्य पेज पर जाना होगा, 3 बिंदुओं पर क्लिक करना होगा, और "एकीकरण से कनेक्ट करें" चुनना होगा।

3. अपने क्लाइंट में MCP कॉन्फ़िगरेशन जोड़ना

npm का उपयोग करना

Cursor और Claude

अपने .cursor/mcp.json या claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json) में निम्नलिखित जोड़ें

विकल्प 1: NOTION_TOKEN का उपयोग करना (अनुशंसित)

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

विकल्प 2: OPENAPI_MCP_HEADERS का उपयोग करना (उन्नत उपयोग के मामलों के लिए)

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\" }"
      }
    }
  }
}

Zed

अपने settings.json में निम्नलिखित जोड़ें

{
  "context_servers": {
    "some-context-server": {
      "command": {
        "path": "npx",
        "args": ["-y", "@notionhq/notion-mcp-server"],
        "env": {
          "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\" }"
        }
      },
      "settings": {}
    }
  }
}

GitHub Copilot CLI

MCP सर्वर को इंटरैक्टिव रूप से जोड़ने के लिए Copilot CLI का उपयोग करें:

/mcp add

वैकल्पिक रूप से, कॉन्फ़िगरेशन फ़ाइल ~/.copilot/mcp-config.json बनाएं या संपादित करें और जोड़ें:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

अधिक जानकारी के लिए, Copilot CLI दस्तावेज़ीकरण देखें।

Docker का उपयोग करना

Docker के साथ MCP सर्वर चलाने के लिए दो विकल्प हैं:

विकल्प 1: आधिकारिक Docker Hub छवि का उपयोग करना

अपने .cursor/mcp.json या claude_desktop_config.json में निम्नलिखित जोड़ें

NOTION_TOKEN का उपयोग करना (अनुशंसित):

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "NOTION_TOKEN",
        "mcp/notion"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

OPENAPI_MCP_HEADERS का उपयोग करना (उन्नत उपयोग के मामलों के लिए):

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2025-09-03\"}"
      }
    }
  }
}

यह दृष्टिकोण:

• आधिकारिक Docker Hub छवि का उपयोग करता है
• पर्यावरण चर के माध्यम से JSON एस्केपिंग को ठीक से संभालता है
• अधिक विश्वसनीय कॉन्फ़िगरेशन विधि प्रदान करता है

विकल्प 2: Docker छवि को स्थानीय रूप से बनाना

आप Docker छवि को स्थानीय रूप से भी बना और चला सकते हैं। पहले, Docker छवि बनाएं:

docker compose build

फिर, अपने .cursor/mcp.json या claude_desktop_config.json में निम्नलिखित जोड़ें

NOTION_TOKEN का उपयोग करना (अनुशंसित):

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "NOTION_TOKEN=ntn_****",
        "notion-mcp-server"
      ]
    }
  }
}

OPENAPI_MCP_HEADERS का उपयोग करना (उन्नत उपयोग के मामलों के लिए):

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2025-09-03\"}",
        "notion-mcp-server"
      ]
    }
  }
}

अपने एकीकरण रहस्य के साथ ntn_**** को बदलना न भूलें। इसे अपने एकीकरण कॉन्फ़िगरेशन टैब से खोजें:

परिवहन विकल्प

Notion MCP सर्वर दो परिवहन मोड का समर्थन करता है:

STDIO परिवहन (डिफ़ॉल्ट)

डिफ़ॉल्ट परिवहन मोड संचार के लिए मानक इनपुट/आउटपुट का उपयोग करता है। यह अधिकांश क्लाइंट जैसे Claude Desktop द्वारा उपयोग किया जाने वाला मानक MCP परिवहन है।

# Run with default stdio transport
npx @notionhq/notion-mcp-server

# Or explicitly specify stdio
npx @notionhq/notion-mcp-server --transport stdio

स्ट्रीमेबल HTTP परिवहन

वेब-आधारित अनुप्रयोगों या क्लाइंट के लिए जो HTTP संचार पसंद करते हैं, आप स्ट्रीमेबल HTTP परिवहन का उपयोग कर सकते हैं:

# Run with Streamable HTTP transport on port 3000 (default)
npx @notionhq/notion-mcp-server --transport http

# Run on a custom port
npx @notionhq/notion-mcp-server --transport http --port 8080

# Bind to a different host. The default is 127.0.0.1.
npx @notionhq/notion-mcp-server --transport http --host 0.0.0.0

# Run with a custom authentication token
npx @notionhq/notion-mcp-server --transport http --auth-token "your-secret-token"

स्ट्रीमेबल HTTP परिवहन का उपयोग करते समय, सर्वर डिफ़ॉल्ट रूप से http://127.0.0.1:<port>/mcp पर उपलब्ध होगा।

प्रमाणीकरण

स्ट्रीमेबल HTTP परिवहन को सुरक्षा के लिए बियरर टोकन प्रमाणीकरण की आवश्यकता होती है। आपके पास तीन विकल्प हैं:

विकल्प 1: स्वतः-जनित टोकन (केवल विकास के लिए)

npx @notionhq/notion-mcp-server --transport http

सर्वर एक सुरक्षित यादृच्छिक टोकन उत्पन्न करेगा और इसे प्रतिबंधित अनुमतियों वाली फ़ाइल में लिखेगा:

Generated auth token written to: /tmp/.notion-mcp-auth-token-12345

विकल्प 2: कमांड लाइन के माध्यम से कस्टम टोकन (उत्पादन के लिए अनुशंसित)

npx @notionhq/notion-mcp-server --transport http --auth-token "your-secret-token"

विकल्प 3: पर्यावरण चर के माध्यम से कस्टम टोकन (उत्पादन के लिए अनुशंसित)

AUTH_TOKEN="your-secret-token" npx @notionhq/notion-mcp-server --transport http

कमांड लाइन तर्क --auth-token दोनों प्रदान किए जाने पर AUTH_TOKEN पर्यावरण चर पर प्राथमिकता लेता है।

असुरक्षित विकल्प: HTTP प्रमाणीकरण अक्षम करें

आप केवल स्पष्ट असुरक्षित ध्वज के साथ बियरर टोकन प्रमाणीकरण अक्षम कर सकते हैं:

npx @notionhq/notion-mcp-server --transport http --unsafe-disable-auth

चेतावनी: --unsafe-disable-auth असुरक्षित है। सर्वर DNS रीबाइंडिंग के माध्यम से आपके द्वारा देखे जाने वाले पेजों तक पहुंच योग्य हो सकता है। इसे केवल एक पृथक नेटवर्क पर उपयोग करें।

जब प्रमाणीकरण अक्षम होता है, तो सर्वर कॉन्फ़िगर किए गए स्थानीय होस्ट और लूपबैक होस्ट के विरुद्ध Host और Origin हेडर की जांच करके DNS रीबाइंडिंग सुरक्षा सक्षम करता है। पिछला --disable-auth ध्वज अभी भी एक पदावनत उपनाम के रूप में स्वीकार किया जाता है, लेकिन यह एक चेतावनी प्रिंट करेगा।

HTTP अनुरोध करना

स्ट्रीमेबल HTTP परिवहन के सभी अनुरोधों में Authorization हेडर में बियरर टोकन शामिल होना चाहिए:

# Example request
curl -H "Authorization: Bearer your-token-here" \
     -H "Content-Type: application/json" \
     -H "mcp-session-id: your-session-id" \
     -d '{"jsonrpc": "2.0", "method": "initialize", "params": {}, "id": 1}' \
     http://localhost:3000/mcp

नोट: किसी भी परिवहन मोड का उपयोग करते समय अपने Notion एकीकरण टोकन के साथ NOTION_TOKEN पर्यावरण चर (अनुशंसित) या OPENAPI_MCP_HEADERS पर्यावरण चर सेट करना सुनिश्चित करें।

कई एकीकरणों की सेवा (प्रति-अनुरोध टोकन पासथ्रू)

डिफ़ॉल्ट रूप से सर्वर स्टार्टअप पर एक ही टोकन के साथ Notion को प्रमाणित करता है, जो एक तैनाती को एक Notion एकीकरण तक लॉक कर देता है। एक एकल तैनाती को कई एकीकरणों की सेवा करने देने के लिए, टोकन पासथ्रू सक्षम करें ताकि प्रत्येक क्लाइंट अपना स्वयं का Notion एकीकरण टोकन प्रति कनेक्शन प्रदान करे:

# Enable per-request Notion tokens (flag or ENABLE_TOKEN_PASSTHROUGH=true)
npx @notionhq/notion-mcp-server --transport http --enable-token-passthrough

क्लाइंट फिर समर्पित Notion-Token हेडर का उपयोग करके initialize अनुरोध पर अपना Notion टोकन भेजते हैं:

curl -H "Authorization: Bearer <server-auth-token>" \
     -H "Notion-Token: ntn_****" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc": "2.0", "method": "initialize", "params": {}, "id": 1}' \
     http://localhost:3000/mcp

प्रत्येक कनेक्शन के लिए टोकन कैसे हल किया जाता है, क्रम में:

1. Notion-Token हेडर (पसंदीदा — स्पष्ट, और सर्वर के स्वयं के Authorization गेटवे प्रमाणीकरण के साथ काम करता है)। यदि मौजूद है तो यह एक मान्य Notion टोकन होना चाहिए, अन्यथा अनुरोध 401 के साथ अस्वीकार कर दिया जाता है।
2. Authorization: Bearer ntn_**** — केवल जब सर्वर का स्वयं का बियरर प्रमाणीकरण बंद हो (--unsafe-disable-auth), ताकि हेडर सीधे Notion टोकन ले जाने के लिए स्वतंत्र हो।
3. अन्यथा स्टार्टअप env टोकन (NOTION_TOKEN / OPENAPI_MCP_HEADERS), यदि सेट है, ताकि पासथ्रू और एक डिफ़ॉल्ट एकीकरण एक तैनाती पर सह-अस्तित्व में रह सकें।

नोट:

• केवल Notion टोकन उपसर्ग (ntn_, विरासत secret_) वाले मान Notion टोकन के रूप में माने जाते हैं, इसलिए सर्वर का गेटवे रहस्य और एक किरायेदार का Notion टोकन कभी टकराते नहीं हैं।
• प्रत्येक टोकन अपने MCP सत्र से बंधा होता है; टोकन कभी लॉग नहीं किए जाते (केवल एक संपादित उपसर्ग उत्सर्जित होता है)।
• यह एक जानबूझकर टोकन-पासथ्रू सेटअप है। इसे हमेशा TLS पर तैनात करें, और मल्टी-टेनेंट ट्रैफ़िक के सामने गेटवे के रूप में सर्वर के स्वयं के बियरर प्रमाणीकरण (--auth-token) को सक्षम रखना पसंद करें।

उदाहरण

1. निम्नलिखित निर्देश का उपयोग करना

Comment "Hello MCP" on page "Getting started"

AI कार्य को पूरा करने के लिए दो API कॉल, v1/search और v1/comments, की सही ढंग से योजना बनाएगा

1. इसी तरह, निम्नलिखित निर्देश के परिणामस्वरूप पैरेंट पेज "Development" में "Notion MCP" नामक एक नया पेज जोड़ा जाएगा

Add a page titled "Notion MCP" to page "Development"

1. आप सामग्री आईडी को सीधे भी संदर्भित कर सकते हैं

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

विकास

बिल्ड और परीक्षण

npm run build
npm test

निष्पादन

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Cursor में परिवर्तनों का स्थानीय रूप से परीक्षण करना:

1. रिपॉजिटरी रूट से npm link कमांड चलाएँ ताकि notion-mcp-server पैकेज के लिए एक मशीन-ग्लोबल सिमलिंक बनाया जा सके।
2. नीचे दिए गए कॉन्फ़िगरेशन स्निपेट को Cursor के mcp.json में मर्ज करें (या किसी अन्य MCP क्लाइंट में जिसके साथ आप परीक्षण करना चाहते हैं)।
3. (सफाई) रिपॉजिटरी रूट से npm unlink चलाएँ।

{
  "mcpServers": {
    "notion-local-package": {
      "command": "notion-mcp-server",
      "env": {
        "NOTION_TOKEN": "ntn_..."
      }
    }
  }
}

प्रकाशन

npm login
npm publish --access public