Skip to main content

​
Overview

Friday can fetch pull requests, track repository activity, retrieve commit history, and generate release notes from your GitHub repositories. To enable these capabilities you must connect the GitHub integration to your account. The connection is a one-time OAuth authorization via a GitHub App; after it’s set up Friday will use GitHub automatically whenever a task requires it.

​
Prerequisites

  1. A GitHub account with access to the repositories you want Friday to interact with.
  2. Permission to install GitHub Apps on your account or organization (organization owners can restrict this).

​
Step-by-step guide

Friday will automatically detect when you need to connect to GitHub as part of your regular use.
1

Start with a real GitHub request

Tell Friday what you want to do with GitHub. This gives Friday the context it needs to request access and complete the setup.Example prompts:
  • “List all open pull requests in the myorg/frontend repository.”
  • “Show me the commit history for the main branch in myorg/api from the last week.”
  • “Generate release notes from all merged PRs in myorg/backend since the last release.”
  • “Every Friday at 3pm PT, summarize this week’s merged pull requests and post them to Slack.”
2

Start the OAuth flow

If you haven’t connected GitHub previously, Friday will automatically detect that you need to go through a one-time OAuth flow.
  • Click Connect GitHub.
  • You’ll be redirected to GitHub’s authorization page.
3

Authorize Friday

  • Review the permissions requested by the Friday GitHub App.
  • Select the organization or account you’d like to connect.
  • Choose which repositories Friday can access (all repositories or select specific ones).
  • Click Install & Authorize.
  • GitHub redirects you back to Friday with a confirmation that the connection succeeded.
4

Continue your task

After authentication, the task you set up in Step 1 will continue automatically, and Friday will now be able to interact with your GitHub repositories.
5

Use GitHub for future automations

Whenever you need GitHub in a task simply include the GitHub action in your prompt. Because the integration is now ready, Friday will handle the operation automatically; no further credential steps are required.

​
Security and permissions

  • Token storage: Friday stores the OAuth token securely; the raw token is never exposed to you.
  • Scoped access: The GitHub App only has access to the repositories you selected during installation. Permissions are grouped into three tiers:
    • Minimal (read-only) — Read access to repository metadata, pull requests, issues, and commit history.
    • Standard (development) — Read and write access to pull requests, issues, and commit statuses. Enables creating PRs and commenting.
    • Full access — All standard permissions plus repository contents (read/write), workflows, and webhooks. Required for Claude Code operations.
  • Revoking access: Uninstalling the Friday GitHub App from your account or organization immediately disables all GitHub actions for Friday.

​
Revoking access

Note: By revoking access, any current and future Spaces set up with Friday will no longer be able to use GitHub until you reconnect. To remove the GitHub token from Friday:
  1. In Friday, go to Settings → Integrations.
  2. Find GitHub and click Remove.
To uninstall the Friday GitHub App from your account:
  1. Go to GitHub Settings → Applications → Installed GitHub Apps.
  2. Find the Friday app.
  3. Click Configure, then click Uninstall.
After uninstalling, any future Friday request that involves GitHub will trigger the OAuth flow again, requiring you to reconnect.

​
Next steps

Capabilities and Integrations

See the full list of what Friday can connect to

Troubleshooting

Solutions for common integration issues