About limited-github-cli-mcp
limited-github-cli-mcp is an MCP server for managing GitHub pull requests through the locally installed GitHub CLI. It uses the CLI's existing authentication rather than handling a GitHub access token directly.
Key features
- 01Create pull requests with branch and draft options
- 02List pull requests with filters
- 03View pull request details
- 04Comment on pull requests
Use cases
- 01Open a pull request from a local repository
- 02Find pull requests by state or base branch
- 03Review a pull request's details
- 04Post a comment on a pull request
MCP support
It exposes pull request creation, listing, viewing, and commenting as tools for MCP clients. Operations use the local `gh` command and its authentication.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMElimited-github-cli-mcp
An MCP server that uses GitHub CLI to perform pull request (PR) operations on GitHub. It leverages the local gh command without requiring a GitHub Access Token.
Features
This MCP server provides the following features:
-
Create PR (
create_pr)- Specify title, body, base branch, head branch, and draft option
-
List PRs (
list_prs)- Filter by state (open, closed, merged, all), base branch, and limit the number of results
-
View PR (
view_pr)- Get detailed information about a specific PR by number
-
Comment on PR (
comment_pr)- Add a comment to a PR by specifying PR number and comment body
Prerequisites
- GitHub CLI (
gh) installed - Logged in to GitHub account using
gh auth login - Local clone of the GitHub repository you want to work with
Usage Examples
Create a PR
use_mcp_tool({
server_name: "limited-github-cli",
tool_name: "create_pr",
arguments: {
title: "Add new feature",
body: "This PR adds feature X",
base: "main",
head: "feature/x",
draft: true
}
})
List PRs
use_mcp_tool({
server_name: "limited-github-cli",
tool_name: "list_prs",
arguments: {
state: "open",
limit: 5
}
})
View PR Details
use_mcp_tool({
server_name: "limited-github-cli",
tool_name: "view_pr",
arguments: {
number: 123
}
})
Comment on PR
use_mcp_tool({
server_name: "limited-github-cli",
tool_name: "comment_pr",
arguments: {
number: 123,
body: "I've reviewed this. LGTM!"
}
})
Security
This MCP server uses the local GitHub CLI, so it doesn't directly handle GitHub Access Tokens. It leverages the authentication credentials of the GitHub CLI, making it a secure way to perform GitHub operations.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.