GitHub

Overview

The GitHub integration connects your GitHub repositories to Monday Morning, enabling bidirectional issue sync and pull request linking. When configured, your AI coding agent can pull GitHub issues into Monday Morning’s issue tracker and link PRs directly to spec tasks — keeping your project management in sync with your development workflow.

Prerequisites

• A GitHub account with access to the target repository
• A Personal Access Token (classic) with repo and read:org scopes
• Monday Morning MCP server running in your AI coding tool

Setup

Step 1: Generate a Personal Access Token

1. Go to github.com/settings/tokens/new
2. Give the token a descriptive name (e.g., “Monday Morning”)
3. Select the following scopes:
   • repo — full control of private repositories
   • read:org — read org membership (needed for org-owned repos)
4. Click Generate token and copy the value immediately — you will not see it again

Step 2: Configure in Monday Morning

Set the GITHUB_TOKEN environment variable in your shell profile:

export GITHUB_TOKEN="ghp_your_token_here"

Alternatively, configure it through the Monday Morning desktop app under Settings > Integrations > GitHub and paste your token into the Personal Access Token field.

Step 3: Verify the Connection

Ask your AI agent to sync GitHub issues:

Sync my GitHub issues for this project

The agent will call mm_sync_github with a pull direction. If configured correctly, you will see issues from your repository appear in .mm/issues/.

Available Tools

The GitHub plugin provides two MCP tools:

Tool	Description
mm_sync_github	Sync issues bidirectionally between GitHub and Monday Morning. Supports pull, push, or both directions.
mm_link_github_pr	Link a GitHub pull request to a task in a spec’s implementation.md.

Common Workflows

Pull issues from GitHub into Monday Morning

Pull all open GitHub issues into this project

The agent calls mm_sync_github with direction: "pull", creating corresponding issue files in .mm/issues/.

Link a PR to a spec task

Link PR #42 to the "Add dark mode" task in the 2026-03-15-dark-mode spec

The agent calls mm_link_github_pr, which annotates the task in implementation.md with the PR reference.

Push Monday Morning issues back to GitHub

Push my local issues to GitHub

The agent calls mm_sync_github with direction: "push", creating GitHub issues from your .mm/issues/ files.

Troubleshooting

“Bad credentials” error Your token is expired or invalid. Generate a new one at github.com/settings/tokens.

“Not Found” when syncing a private repo Ensure your token has the repo scope. Tokens with only public_repo cannot access private repositories.

Issues not appearing after sync Check that the project’s Git remote points to the correct GitHub repository. Monday Morning reads the origin remote to determine which repo to sync with.

Rate limiting GitHub allows 5,000 API requests per hour for authenticated users. If you hit the limit, wait for the reset window or reduce sync frequency.