hwchase17/notion-qa
hwchase17/notion-qa has 2,151 GitHub stars and 354 forks. GitHot measured -1 stars in 24 hours and -1 in 7 days. Last checked 2026-11-09 20:59 UTC. Last push 2024-09-06.
🤖Ask questions to your Notion database in natural language🤖
Measured star growth
- in 24h
- -1
- in 7 days
- -1
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.md
OriginalNotion Question-Answering
🤖Ask questions to your Notion database in natural language🤖
💪 Built with LangChain
🌲 Environment Setup
In order to set your environment up to run the code here, first install all requirements:
pip install -r requirements.txt
Then set your OpenAI API key (if you don't have one, get one here)
export OPENAI_API_KEY=....
📄 What is in here?
- Example data from Blendle
- Python script to query Notion with a question
- Code to deploy on StreamLit
- Instructions for ingesting your own dataset
📊 Example Data
This repo uses the Blendle Employee Handbook as an example. It was downloaded October 18th so may have changed slightly since then!
💬 Ask a question
In order to ask a question, run a command like:
python qa.py "is there food in the office?"
You can switch out is there food in the office? for any question of your liking!
This exposes a chat interface for interacting with a Notion database. IMO, this is a more natural and convenient interface for getting information.
🚀 Code to deploy on StreamLit
The code to run the StreamLit app is in main.py.
Note that when setting up your StreamLit app you should make sure to add OPENAI_API_KEY as a secret environment variable.
🧑 Instructions for ingesting your own dataset
Export your dataset from Notion. You can do this by clicking on the three dots in the upper right hand corner and then clicking Export.

When exporting, make sure to select the Markdown & CSV format option.

This will produce a .zip file in your Downloads folder. Move the .zip file into this repository.
Run the following command to unzip the zip file (replace the Export... with your own file name as needed).
unzip Export-d3adfe0f-3131-4bf3-8987-a52017fc1bae.zip -d Notion_DB
Run the following command to ingest the data.
python ingest.py
Boom! Now you're done, and you can ask it questions like:
python qa.py "is there food in the office?"
Explore related projects
codecrafters-io/build-your-own-x
Master programming by recreating your favorite technologies from scratch.
561,398 starspublic-apis/public-apis
A collective list of free APIs
497,679 starsmorluto/rea
Reverse engineer anything with agents, from app behavior down to native binaries.
447,495 starsopenclaw/openclaw
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
394,261 stars