DEV Community

Cover image for Notican: I Built an AI That Writes Your Engineering Docs From GitHub Automatically
Ercan Ermiş
Ercan Ermiş

Posted on

Notican: I Built an AI That Writes Your Engineering Docs From GitHub Automatically

Notion MCP Challenge Submission 🧠

This is a submission for the Notion MCP Challenge

What I Built

Notican is an Autonomous Engineering Intelligence Hub that connects GitHub to Notion using Claude AI. Every PR, commit, and issue becomes living documentation automatically. no manual work required.

When you merge a PR, Claude reads the diff and writes a Changelog entry. If the change is architectural, it generates an Architecture Decision Record. When you push API file changes, it updates your API Reference. Infrastructure changes trigger Runbooks.

GitHub issues become Notion tasks. And Notion tasks tagged for sync automatically create GitHub issues back.

Five databases. Zero effort. Always up to date.

Video Demo

[Record a short walkthrough: webhook firing, Claude analyzing the diff, Notion page appearing in real time]

Show us the code

https://github.com/flightlesstux/notican

Live site: https://notican.click

How I Used Notion MCP

Notion MCP is the write layer of the entire system. Every Claude-generated document flows into Notion through the MCP client; changelogs, ADRs, API references runbooks, and tasks. All writes are idempotent: each page is keyed by a GitHub external ID (PR number, commit SHA, issue number), so re-processing an event updates the page rather than duplicating it.

The bidirectional piece is what makes it truly powerful. A Notion task watcher polls every 60 seconds for tasks tagged github_sync. When it finds one, it calls the GitHub API to create an issue with full context, then marks the task synced. Notion becomes the single source of truth for the entire engineering workflow.

Top comments (0)