To connect GitHub to Neo.Tax, you will install the Neo.Tax GitHub App on your GitHub organization. It takes about a minute and does not require a personal access token.

You'll need to be a GitHub organization admin—or have an admin approve the installation. The steps below walk you through it.

After connecting, upload a CSV mapping GitHub user IDs to work emails, so the data from GitHub can be mapped to payroll later.

Part 1: Connect GitHub

  1. Log in to app.neo.tax and go to Projects → Connect Project Management → select Install the Neo.Tax GitHub App

    Screenshot 2026-09-10 at 10.06.05 AM.png

  2. Enter your GitHub organization (for example, acme-inc).

    Screenshot 2026-09-10 at 10.06.40 AM.png

  3. Click Install on GitHub. You'll be taken to GitHub to install the Neo.Tax GitHub App on your organization.

    Screenshot 2026-09-10 at 10.07.11 AM.png

    1. Confirm you have the correct organization selected. If you are owner of multiple organizations, you may need to select the correct one.

  4. Select All Repositories (recommended).

    1. If you have certain repositories that you want to exclude, please discuss with Neo.Tax. We will only be able to identify R&D for the repositories we are given access to.

  5. Click Authorize & Request. You'll be returned to Neo.Tax, which confirms the connection automatically—you'll see “GitHub App Installed—GitHub is connected.”

<aside> ℹ️ You must be a GitHub organization admin to install the app. If you’re not, see below.

</aside>

If you're not a GitHub organization admin, there’s 1 more step

When you start the installation, GitHub sends an approval request to an owner of your GitHub organization, and Neo.Tax shows “Waiting on Your GitHub Admin.”

Once an owner approves the request, come back to Neo.Tax and connect GitHub again to finish. Approval on its own doesn't complete the connection.

Troubleshooting

<aside> ⚠️ If GitHub shows a configuration page instead of an install screen, this means the Neo.Tax GitHub App is already installed on your organization. Uninstall it from your GitHub organization's Settings → Installed GitHub Apps. Then retry the installation process from the Neo.Tax app.

</aside>

Part 2: Mapping GitHub to payroll

To match GitHub activity to your payroll data, upload a mapping of GitHub user IDs to work emails:

  1. Create a CSV with two columns: GitHub UserId and Work email.
  2. Go to Neo.Tax → Data Sources → Select Upload Github Emails