← All examples

GitHub Issues Tool

MCP tool that creates, lists, and manages GitHub issues using OAuth. Connect GitHub and triage issues from any agent.

toolgithuboauthissuesmcp
Deploy this example

An MCP tool that connects to GitHub via OAuth. Create issues, list open issues, add labels, and manage repositories — all callable by any agent or MCP client.

What's included

  • OAuth connection — connects to GitHub via Reminix managed OAuth
  • Create issues — open new issues with title, body, and labels
  • List issues — query open issues by repository, label, or assignee
  • MCP server — discoverable and callable by any agent or MCP client

When to use this

Pick the GitHub Issues Tool example when you want to:

  • Build an agent that triages or creates issues automatically
  • Add GitHub integration to a support or engineering agent
  • Learn how OAuth connections work with Reminix tools

How connections work

Reminix handles the GitHub OAuth flow, token exchange, and automatic refresh. Your tool handler receives a valid access token and uses the GitHub API directly.

  1. Create a GitHub OAuth app and add credentials in the Reminix dashboard
  2. Authorize the connection
  3. Your tool gets a fresh access token on every call

Project structure

├── src/
│   ├── index.ts                # Entry point with serve()
│   └── tools/
│       ├── create-issue.ts     # Create a GitHub issue
│       └── list-issues.ts      # List issues by repo
├── package.json
├── tsconfig.json
└── reminix.config.ts

Quick start

After deploying and connecting your GitHub account, any agent in your project can create and query issues automatically.