How-to guide
Use Shuffl with Notion
Connect Notion to let Mello answer from your documents, and see what Shuffl does with it.
For HR and IT administrators
Have your agent do thisPaste the prompt into Claude Code, Cursor or another agent. It follows this guide over MCP and asks before it changes anything others will see.Show the promptHide the prompt
Help me with "Use Shuffl with Notion" in my Shuffl workspace. 1. Read the guide: https://shuffl.ai/docs/markdown/notion 2. Add Shuffl's MCP server: https://shuffl.ai/api/mcp Claude Code: claude mcp add --transport http shuffl https://shuffl.ai/api/mcp When the browser opens, choose my workspace and allow the access the guide needs. 3. Work through the steps in order: Answer from Notion. Do what you can over MCP and tell me which steps only I can do in the browser or in Slack. Show me what you will change and who it affects, and wait for my yes before publishing, inviting or sending anything.
On this page
App links open your signed-in workspace. Check the selected workspace before making changes.
What Notion does in Shuffl
If your handbook is a set of Notion pages, Mello can answer from them with a citation. Share each page with the Shuffl connection, and HR reviews every change.
You need to be a Shuffl workspace administrator, with an administrator in Notion for the steps there.
Answer from Notion
- On Knowledge → Connections, choose Connect next to Notion.
- Authorize Shuffl in your Notion workspace.
- In Notion, share each policy page with the Shuffl connection.
- Paste the page link into Shuffl; it is read as a draft for review.
- Check the draft’s text, audience and review date, then publish it.
Shuffl reads: Pages. You pick each one, and Shuffl never writes to Notion.
In Shuffl
- Mello answers from what you publish, with a citation, to the audience you set.
- A new version in Notion becomes a draft for HR to review. The old text stops being used once the change is found.
- Disconnecting withdraws every document it brought in. The originals stay where they are.
Good to know
Linked private pages, databases and meeting transcripts aren’t imported. Share each page you want on its own.
If it stops working
When a source reads Access lost or Sync needs attention, check that the connected account can still open it in Notion, then choose Check now.
Disconnect and withdraw deletes the stored key and withdraws what it brought in. Drafts, versions and the originals stay.