How to Build a Notion AI Chatbot for Your Help Center A tutorial by Quickchat AI demonstrates building a Notion AI chatbot for a help center using Notion's hosted MCP server, which publishes 28 tools, and emphasizes using two separate Notion connections—one read-only and one write-only—to ensure reliable write-back and safety. The example agent, Quay, answers questions from help center pages, checks a Known issues database, and logs support requests, with the design focused on making the write operation trustworthy. A Notion AI chatbot answers questions from the pages you keep in Notion, and the useful version does more than that: it reads a Notion database for anything that changes daily, and it writes back to Notion when a visitor needs a human. This tutorial builds one on Notion’s MCP server https://developers.notion.com/docs/mcp , end to end, for a fictional company whose help center and support queue both live in Notion, and then tests it the way a customer and an attacker would. Everything below was built and measured on a real Notion account. Every screenshot is from the working agent, and where its behavior needed tuning, the numbers that drove each rule are in the post. What you will build A fictional company, Harborline , sells shift-scheduling software to restaurants and cafes. Its help center is six Notion pages, its open incidents are rows in a Notion database called Known issues , and its support queue is another Notion database called Support requests . Its website agent, Quay , does four things in one conversation: - answers product questions from the live help center pages, naming the page it used; - checks the Known issues database when a visitor reports something broken, and passes on the workaround; - says plainly when the help center has nothing, instead of inventing an answer; - logs a support request as a new row in the Support requests database, and adds to that same row when the visitor remembers one more detail. The four jobs. The first three read through one Notion connection; the fourth writes through another, and the whole tutorial turns on making the write trustworthy. What you need: a free Quickchat AI account https://app.quickchat.ai/register and a Notion account. There is no code anywhere in this tutorial. The fourth job is where this post spends most of its time, for two reasons. Writing to Notion is the part that has to be reliable a visitor who is told “logged” while nothing was logged is worse off than one who was told “I cannot do that” , and it is the part where the shape of the connection matters. Quay runs on two Notion connections , one that only reads and one that only writes, and the safety section is-connecting-notion-to-a-chatbot-safe shows with receipts why one connection is not enough. What is the Notion MCP server? Notion publishes a hosted MCP server at mcp.notion.com . MCP Model Context Protocol is a standard way for an AI agent to discover and call another product’s operations, and “hosted” means there is nothing to install or update: you approve the connection once, and the tools Notion publishes appear in your agent. On the day this was written the server published 28 tools : searching and fetching pages, creating and updating pages and databases, moving and duplicating pages, commenting, listing members, and driving Notion’s own agents. Three facts about this server shape the design more than anything in the prompt: The grant is your access. Notion’s consent screen says it in as many words: the connected app will “respect your page and database access and permissions” and “take actions on your behalf, based on your access level.” There is no page picker. Whatever the connecting user can see, the tools can see. The boundary of what a public agent can reach is therefore the workspace you connect , plus the tool list. Every tool result is JSON. A search returns titles, URLs and snippets; a page fetch returns the page as Markdown inside a JSON envelope; creating a page returns the new page’s identifier and URL. That last detail is what makes the write-back reliable: the identifier can be saved and used later in the same conversation. Writes are ordinary tools. notion-create-pages , notion-move-pages and friends sit next to notion-search in the same list. Which of them your agent can call is decided in Quickchat AI, tool by tool, and this tutorial keeps the list very short. The parties. The visitor only chats. Each connection was approved from a different workspace and carries a different two-tool list, so the reader can only read the help center and the writer can only write the queue. How do you create the Harborline agent? Create the agent and give it its job before you connect anything. Quay’s Knowledge Base stays empty on purpose : every answer should come from Notion, so the only source of product facts is the help center. The comparison section notion-mcp-or-importing-notion-into-a-knowledge-base covers when you would import instead. Open AI Agent → Identity , set Name to Quay, and paste the Main Prompt https://docs.quickchat.ai/ai-agent/identity/ main-prompt below. Two values in it are yours to replace: the URL of your Known issues database, and the identifier of your Support requests database, which is the 32-character string at the end of that database’s URL in the browser’s address bar. Identity → Name and Main Prompt. With the Knowledge Base empty, the prompt is the only place that tells the agent where its facts come from. You are Quay, the support assistant for Harborline, shift-scheduling software for restaurants and cafes. You answer from the Harborline Help Center in Notion, and you log support requests in the Support requests database in Notion. Answering questions: - Search the help center first, then read the page that matches before you answer. Base every answer on what the page says and name the page you used. - For anything that sounds like an outage, a delay or a bug, read the Known issues database