FoxPlug Help / Connect your tools

Connect GitHub: what to paste and what FoxPlug reads

GitHub is where most makers keep their code, review it in pull requests, tag releases, track issues and run builds with GitHub Actions. FoxPlug reads it only when you press Check for what's new. What you give it: fine-grained personal access token pasted into the connect panel (a Connect button with GitHub sign-in also exists in the app).

Where to find it: In FoxPlug open Settings, then Publishing & integrations, then the row "GitHub", and press How to connect next to GitHub. Faster: press / in Settings and type GitHub. Open it in FoxPlug

Steps

1. Open github.com/settings/personal-access-tokens/new.
2. Name the token (FoxPlug) and choose when it expires.
3. Resource owner: pick your own account.
4. Repository access: only select repositories, or all repositories.
5. Under Permissions, Repository: set Contents to Read-only and Metadata to Read-only. To see issues you closed in private repositories, also set Issues to Read-only.
6. To use GitHub Actions reading, also set Actions to Read-only (a classic token needs the repo scope).
7. Generate the token, copy it (GitHub shows it once) and paste it into FoxPlug.
8. Press the connect button in FoxPlug. FoxPlug checks the key or sign-in straight away and tells you in plain words if it was refused.

Good to know

• What to give: fine-grained personal access token pasted into the connect panel (a Connect button with GitHub sign-in also exists in the app). Give it read-only access.
• What FoxPlug looks at: the documentation pages in one folder you name (optional); the repositories the token can see; releases; merged pull requests; closed issues.
• Everything FoxPlug reads from GitHub, and what it never reads, is on its integration page.
• You can disconnect any time from the same place, and the stored key is deleted.

What it does not do

• your code files: the docs check reads only Markdown and text pages inside the one folder you name, and only when you press Check docs.
• who reported or who is assigned to an issue, and any comment text.
• the contents or diffs of your files (the calls made list repositories, releases, pull requests, issues, commits and workflow runs only).
• anything it could change: it makes read requests only and never re-runs, cancels or edits a workflow.
• pull request authors, commit authors or reviewers (only the title, body, message and time are taken).

Related

• The Your connections card: what each state means
• The Check for what's new button
• Connect Stripe: what to paste and what FoxPlug reads
• Connect Vercel: what to paste and what FoxPlug reads

Something here not matching what you see? Write to hello@foxplug.com and say which line. Last checked 2026-11-13.