aytoast/notion-git

notion-git brings a Git-like way of working to Notion, the note taking and workspace tool. Instead of your AI coding agent or IDE constantly calling the Notion API or relying on a shaky MCP connection, this tool keeps a local copy of your Notion pages as plain Markdown files on your computer. Your editor or agent can then read those files instantly, without waiting on network calls each time it needs context. The commands are named after familiar Git commands. Clone downloads your Notion workspace into a local markdown folder. Diff compares your local edits against what is currently live on Notion so you can see what would change. Pull fetches the latest changes from Notion and updates your local files to match. Push would send your local edits back up to Notion, using the API for normal page content and a lower level block API for anything that method does not support. As of this README, pull is the command that is fully built, while the others describe the plan for what is coming next. One practical benefit is authentication. Rather than dealing with OAuth logins that expire and force you to reconnect, this tool uses a single long lived integration token stored in a .env file, so it keeps working without repeated logins. Under the hood, the project separates high level sync commands, which live under a skills folder, from low level wrappers around individual Notion API endpoints, which live under an api folder. Those low level wrappers handle specific actions like creating a page, fetching a block, or updating page content, and the higher level pull command builds on top of them. To set it up, you clone the repository, add your Notion integration token to a .env file, and create a small configuration file naming the page or database you want to track.