# github-mcp-connector MCP server

MCP server for GitHub: repos, files, issues, PRs, search. Single Go binary.

## At a glance

github-mcp-connector is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip`, and needs GITHUB_TOKEN. It exposes 18 tools, including github_whoami, github_list_repos and github_get_repo. It scores B (76/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install github-mcp-connector in Claude Code

1. Add the server

```bash
claude mcp add github-mcp-connector -e 'GITHUB_TOKEN=<GITHUB_TOKEN>' -- npx -y https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip
```

2. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. github_whoami, github_list_repos, github_get_repo). It discovers them automatically.

### How to install github-mcp-connector in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "github-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install github-mcp-connector in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "github-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install github-mcp-connector in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.github-mcp-connector]
command = "npx"
args = ["-y", "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"]
env = { GITHUB_TOKEN = "<GITHUB_TOKEN>" }
```

2. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install github-mcp-connector in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "github-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install github-mcp-connector in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "github-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

### How to install github-mcp-connector in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "github-mcp-connector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/FerhatDundar/github-mcp-connector/releases/download/v0.1.1/github-mcp-connector-plugin-v0.1.1-darwin-arm64.zip"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <GITHUB_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `github_whoami` — Get the user authenticated by `GITHUB_TOKEN`
- `github_list_repos` — List repos for a user/org, or the authenticated user
- `github_get_repo` — Get one repository's details
- `github_create_repo` — Create a new repository
- `github_list_branches` — List branches in a repository
- `github_list_commits` — List commits, optionally filtered by branch/path
- `github_get_file_contents` — Read a file's content, or list a directory
- `github_create_or_update_file` — Create/update a file via a commit (≤ 5 MB)
- `github_list_issues` — List issues in a repository
- `github_get_issue` — Get one issue's full details
- `github_create_issue` — Create a new issue
- `github_update_issue` — Update an issue's title/body/state/labels
- `github_add_issue_comment` — Comment on an issue or PR
- `github_list_pull_requests` — List pull requests
- `github_get_pull_request` — Get one PR's full details, incl. diff stats
- `github_create_pull_request` — Open a pull request
- `github_merge_pull_request` — Merge a pull request
- `github_search_repositories` — Search repositories with GitHub search qualifiers

Source repository: https://github.com/FerhatDundar/github-mcp-connector

---

Source: https://mcp-skills-hub.vercel.app/mcps/io-github-ferhatdundar-github-mcp-connector · MCP Skills Hub · data as of 2026-10-28T12:31:05Z
