[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [GitHub user contributions](https://spiral.ai/integrations/n8n/github-user-contributions)

# How to Use GitHub user contributions in n8n

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.

|  |  |
| --- | --- |
| Model | GitHub user contributions |
| Available through | ScrapeCreators |
| Category | Data |
| Price | $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with GitHub user contributions in n8n

- Every Monday, use GitHub user contributions for torvalds for the current year and summarize the previous Monday through Friday by daily count and total.
- On the third day of each month, use GitHub user contributions for kentcdodds for the current year and summarize the previous month's total and days with contributions.
- Every Friday, use GitHub user contributions for sindresorhus for the current year and compare returned counts with the previous report, listing any revised dates.
- On January 3 each year, use GitHub user contributions for torvalds for the previous year and prepare an annual recap with monthly totals.
- On the third day after each quarter ends, use GitHub user contributions for kentcdodds for the relevant year and report the completed quarter's monthly totals and highest-count day.

## How to set up GitHub user contributions in n8n

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send n8n this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **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

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run GitHub user contributions in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds GitHub user contributions, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GitHub user contributions**: One request; the result comes back by polling or a webhook.

```bash
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: n8n finds GitHub user contributions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/n8n

## GitHub user contributions tools and prices

- [GitHub · Contributions](https://spiral.ai/tools/scrapecreators/scrapecreators/github-user-contributions) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | GitHub profile URL |
| year |  | — | Contribution graph year. Defaults to the current year. |
| handle |  | — | GitHub handle |

## What can you do with GitHub user contributions in n8n?

Produce a recurring contribution digest for a public open source creator. A scheduled agent can compare daily counts across retrievals and flag revisions, allowing for GitHub's contribution delay.

### 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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## GitHub user contributions in other agents

- [Amp](https://spiral.ai/integrations/amp/github-user-contributions)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/github-user-contributions)
- [Claude](https://spiral.ai/integrations/claude-desktop/github-user-contributions)
- [Claude Code](https://spiral.ai/integrations/claude-code/github-user-contributions)
- [Cline](https://spiral.ai/integrations/cline/github-user-contributions)
- [Codex](https://spiral.ai/integrations/codex/github-user-contributions)
- [Cursor](https://spiral.ai/integrations/cursor/github-user-contributions)
- [Devin](https://spiral.ai/integrations/devin/github-user-contributions)
- [dots](https://spiral.ai/integrations/dots/github-user-contributions)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/github-user-contributions)
- [Gemini](https://spiral.ai/integrations/gemini/github-user-contributions)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/github-user-contributions)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/github-user-contributions)
- [goose](https://spiral.ai/integrations/goose/github-user-contributions)
- [Grok](https://spiral.ai/integrations/grok/github-user-contributions)
- [Grok Build](https://spiral.ai/integrations/grok-build/github-user-contributions)
- [Hermes](https://spiral.ai/integrations/hermes/github-user-contributions)
- [Instinct](https://spiral.ai/integrations/instinct/github-user-contributions)
- [Manus](https://spiral.ai/integrations/manus/github-user-contributions)
- [Muse](https://spiral.ai/integrations/muse/github-user-contributions)
- [Muse Code](https://spiral.ai/integrations/muse-code/github-user-contributions)
- [Notion](https://spiral.ai/integrations/notion/github-user-contributions)
- [OpenClaw](https://spiral.ai/integrations/openclaw/github-user-contributions)
- [opencode](https://spiral.ai/integrations/opencode/github-user-contributions)
- [Perplexity](https://spiral.ai/integrations/perplexity/github-user-contributions)
- [Raycast](https://spiral.ai/integrations/raycast/github-user-contributions)
- [VS Code](https://spiral.ai/integrations/vscode/github-user-contributions)
- [Windsurf](https://spiral.ai/integrations/windsurf/github-user-contributions)
- [Zapier](https://spiral.ai/integrations/zapier/github-user-contributions)

## More n8n guides

- [GitHub trending repositories](https://spiral.ai/integrations/n8n/github-trending-repositories)
- [GitHub user followers](https://spiral.ai/integrations/n8n/github-user-followers)
- [GitHub trending developer list](https://spiral.ai/integrations/n8n/github-trending-developer-list)
- [GitHub user following](https://spiral.ai/integrations/n8n/github-user-following)
- [GitHub contribution activity](https://spiral.ai/integrations/n8n/github-contribution-activity)
- [GitHub user profile](https://spiral.ai/integrations/n8n/github-user-profile)

## Questions about GitHub user contributions in n8n

**Can n8n use GitHub user contributions?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run GitHub user contributions like any built-in tool.

**How much does GitHub user contributions cost in n8n?**

$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

**Do I need a ScrapeCreators account to use GitHub user contributions in n8n?**

You need no ScrapeCreators account. n8n uses one Spiral API key for every tool, and Spiral runs GitHub user contributions on its own ScrapeCreators account.

**How long does it take to set up GitHub user contributions in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while GitHub user contributions runs?**

GitHub user contributions runs in the background. n8n 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.

