GitHub Repository Manager

You can run an MCP server that lets AI assistants create and permanently delete GitHub repositories. It’s designed to be simple to set up, secure through environment variables, and compatible with MCP clients like Claude Desktop.

How to use

You interact with the server through an MCP client. First, verify the server is running locally or on your preferred host, and then connect it as an MCP endpoint. Use the available tools to perform repository actions without leaving your chat context. You can create repositories with customizable settings, and you can delete repositories when they are no longer needed. All actions require your GitHub token to authorize changes.

Typical usage patterns include creating a repository by name, optionally marking it private and adding a description, and optionally initializing with a README. You can also remove repositories permanently when necessary. Before performing actions, ensure your MCP client is configured to point to the correct MCP server command and environment. If you need to verify what tools are available, ask your MCP client about the tools exposed by this server.

How to install

Prerequisites: you need Python 3 and access to install Python packages. Ensure you have a GitHub token with repo permissions and a local environment where you can run your MCP server.

Step 1: Install dependencies.

pip install -r requirements.txt

Step 2: Set up your GitHub token in a .env file in the same directory as the MCP server script.

# .env file
GITHUB_TOKEN=your_actual_github_token_here

Step 3: Configure Claude Desktop (or your MCP client) to run the server. Use the following setup, which runs the MCP server script with Python 3.

{
  "darkMode": "dark",
  "scale": 0,
  "mcpServers": {
    "github_repo_mcp": {
      "command": "python3",
      "args": ["/path/to/your/simple_mcp_server.py"],
      "env": {}
    }
  }
}

Additional sections

Configuration notes: the server loads the GitHub token from the .env file, so you do not need to place the token directly in the client configuration. Keep your .env file secure and add it to your .gitignore to prevent accidental commits.

Security reminders: never commit your real GitHub token. Repository deletion is permanent. Use environment variables for sensitive data and rotate tokens regularly.

Available tools

create_github_repository

Creates a new GitHub repository with configurable options such as name, privacy, description, and initial README.

delete_github_repository

Deletes an existing GitHub repository by name, permanently removing it from GitHub.