How to Use GitHub user contributions in Cursor
GitHub user contributions returns a yearly contribution graph with an annual total, dated daily counts, and intensity levels. Use it to build contribution calendars or summarize a public open source creator's activity over time.
Prompts to try with GitHub user contributions in Cursor
Copy an example into Cursor, or ask in your own words.
Use GitHub user contributions for torvalds in 2025 and add a contribution calendar to this project's dashboard, with the date and exact count available for each day.
Use GitHub user contributions for kentcdodds in 2025 and add a CSV export containing each returned date, contribution count, and intensity level.
Use GitHub user contributions for sindresorhus in 2024 and 2025 and build a monthly comparison chart in this project.
Use GitHub user contributions for torvalds in 2025 and create an accessible table beside the chart showing monthly totals and days with contributions.
Use GitHub user contributions for kentcdodds in 2025 and create a recap component showing the annual total, busiest month, and highest-count day.
How to set up GitHub user contributions in Cursor
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.
Use the Spiral skill
- Send Cursor 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 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 user contributions
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-user-contributions", "input": { "url": "https://github.com/torvalds" } }'
Then paste one of the prompts above: Cursor finds GitHub user contributions on Spiral, shows the price and runs it.
GitHub user contributions providers and prices
Spiral runs GitHub user contributions through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Cursor for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Year | a number | Contribution graph year. Defaults to the current year. |
Every API field of GitHub · Contributions is on its tool page: open its card above.
What can you do with GitHub user contributions in Cursor?
Build a contribution calendar for a public open source creator using GitHub's dated daily counts. A coding agent can add monthly summaries and accessible tables to your project.
Build a contribution calendar
Turn a public open source creator's dated counts into a yearly heatmap with exact counts available for each day.
Prepare an annual open source recap
Summarize a public creator's annual total, busiest month, and number of days with recorded contributions.
Compare completed years
Compare annual totals and monthly distributions for the same public creator across two completed years.
Create a monthly activity digest
Aggregate daily counts into a monthly table for a public creator's open source newsletter.
Check historical count revisions
Compare saved graphs with newly retrieved graphs for the same public account and year, listing dates whose counts changed.
Export chart data
Convert a public creator's daily counts and intensity levels into CSV for a contribution chart or an accessible table.
More on GitHub user contributions and Cursor
Overview
GitHub user contributions in other agents
Questions about GitHub user contributions in Cursor
Can Cursor use GitHub user contributions?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run GitHub user contributions like any built-in tool.
How much does GitHub user contributions cost in Cursor?
$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.
Do I need a ScrapeCreators account to use GitHub user contributions in Cursor?
No. Spiral runs GitHub user contributions 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 user contributions in Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while GitHub user contributions runs?
GitHub user contributions runs in the background. Cursor starts the run, checks on it and gives you the json when it's ready.
What does the contribution graph return?
It returns one year of GitHub contribution data, including an annual total and dated daily counts with intensity levels. The documented response also includes a color value, which can be null.
How quickly do new commits appear?
GitHub says a qualifying commit can take up to 24 hours to appear on the contribution graph. A same-day count can therefore be incomplete.
Does the graph count commits on every branch?
No. Commits count only on the repository's default branch or gh-pages branch, so the calendar does not represent every commit across every branch.
Can visible counts include work in private repositories?
Yes, if the account chooses to publicize private contributions. GitHub exposes daily counts to viewers without repository access while withholding the underlying details.
Which time zone determines a commit's contribution day?
GitHub uses the time zone recorded in the commit timestamp. Keep the returned calendar date when grouping daily counts.
Start using GitHub user contributions in Cursor
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cursor:
set up https://spiral.ai/SKILL.md


