How to Use GitHub Repository in Notion
Get one public GitHub repository’s description, language, stars, forks, license, archive status, and timestamps. Use it to compare known projects, enrich a software catalog, or check a dependency’s upstream status.
Prompts to try with GitHub Repository in Notion
Copy an example into Notion, or ask in your own words.
Every Monday, use GitHub repository details for https://github.com/microsoft/TypeScript. Compare archive status, reported license, and default branch with the previous check and report changes.
Each morning, use GitHub repository details for https://github.com/vitejs/vite and https://github.com/webpack/webpack. Save their star and fork totals and report the change since yesterday.
Every Friday, use GitHub repository details for https://github.com/expressjs/express. Report any changes to its description, homepage, topics, or reported license since the previous check.
Every Monday, use GitHub repository details for https://github.com/django/django and https://github.com/pallets/flask. Show archive status and push timestamps, and flag any archive-status change.
On the first day of each month, use GitHub repository details for https://github.com/astral-sh/ruff. Compare its stars and forks with last month’s saved observation and summarize the difference.
How to set up GitHub Repository in Notion
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Notion this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Allow custom MCP servers
A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.
- Add Spiral to a custom agent
Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.
- Run GitHub Repository in a workflow step
Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds GitHub Repository, prices it and runs it each time the step fires.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run GitHub Repository
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/github-repository", "input": { "url": "https://github.com/torvalds/linux" } }'
Then paste one of the prompts above: Notion finds GitHub Repository on Spiral, shows the price and runs it.
GitHub Repository providers and prices
Spiral runs GitHub Repository through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with GitHub Repository in Notion?
Receive a recurring change report for the public GitHub repositories your team depends on. An agent can compare saved observations to flag archive changes, reported license changes, default-branch changes, and shifts in star or fork totals.
Compare a software shortlist
Compare known repositories by description, language, topics, stars, forks, and archive status before choosing which projects to investigate further.
Review upstream dependency status
Check the public repositories behind your dependencies for archive status, default branch, and push timestamps to prioritize maintenance reviews.
Refresh a software catalog
Update catalog entries with repository descriptions, homepages, languages, topics, and links for a known list of projects.
Prepare a license review queue
Collect reported license names and identifiers for candidate dependencies, then route unclear entries for review before code reuse.
Measure changes in project interest
Collect repeated star and fork totals for selected repositories and calculate changes between your saved observations.
Prepare a project research brief
Summarize a repository’s stated purpose, language, topics, license, archive status, and popularity counts for an engineering evaluation.
Detect repository metadata changes
Compare successive observations of a known repository’s description, homepage, default branch, license, and archive status to flag changes for review.
More on GitHub Repository and Notion
Overview
GitHub Repository in other agents
Questions about GitHub Repository in Notion
Can Notion use GitHub Repository?
Yes. Add Spiral to Notion as an MCP server, and Notion can find and run GitHub Repository like any built-in tool.
How much does GitHub Repository cost in Notion?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.
Do I need a ScrapeCreators account to use GitHub Repository in Notion?
No. Spiral runs GitHub Repository on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up GitHub Repository in Notion?
About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.
Does Notion wait while GitHub Repository runs?
GitHub Repository runs in the background. Notion starts the run, checks on it and gives you the json when it's ready.
Does this cover private repositories or return multiple projects?
GitHub repository details covers one public repository per call. Its documented output is repository metadata, so a comparison of five known projects requires five repository lookups.
How fresh is the data, and can I get historical star counts?
ScrapeCreators describes its extraction as real time. The documented repository response contains one set of totals plus creation, update, and push timestamps; build star-growth comparisons from snapshots you collect over time.
Do stars and watchers measure the same thing?
GitHub describes stars as an approximate measure of interest. In its REST responses, watchers_count also counts stars, while subscribers_count counts watchers, so do not interpret the returned watchers count as a separate audience.
What does an archived repository mean?
GitHub uses archiving to make a repository read-only and indicate that it is no longer actively maintained. A repository can later be unarchived, so archive status is useful to check repeatedly when reviewing dependencies.
Does a public repository mean its code is free to reuse?
Public visibility alone does not grant unrestricted reuse rights. GitHub says default copyright rules apply without a license; use the returned license metadata to identify projects that need a closer license review.
Start using GitHub Repository in Notion
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Notion:
set up https://spiral.ai/SKILL.md


