GitHub Gist MCP (Minimal)

December 1, 2025 ยท View on GitHub

A minimal MCP server for creating and managing GitHub Gists. Provides just 4 essential tools to keep context usage low.

Forked from gistpad-mcp by lostintangent.

Why This Fork?

The original gistpad-mcp is excellent and feature-rich with 27+ tools for full gist management. This fork is a pared-down alternative for users who only need basic gist operations and want to minimize MCP context usage. It reduces the toolset to just 4 core operations:

  • Create private gists
  • Create public gists (with auto-appended verification notice)
  • Update gists
  • Delete gists

Getting Started

  1. Generate a GitHub personal access token with the gist scope: https://github.com/settings/tokens/new

  2. Add to your MCP client:

Claude Code:

claude mcp add github-gist --scope user --env GITHUB_TOKEN=ghp_xxxxxxxxxxxx -- npx -y github-gist-mcp-minimal

Other MCP clients:

{
  "mcpServers": {
    "github-gist": {
      "command": "npx",
      "args": ["-y", "github-gist-mcp-minimal"],
      "env": {
        "GITHUB_TOKEN": "<YOUR_PAT>"
      }
    }
  }
}

Tools

ToolDescription
create_private_gistCreate a new private GitHub Gist
create_public_gistCreate a new public GitHub Gist (includes verification footer)
update_gistUpdate the content of a file in a gist
delete_gistDelete a GitHub Gist by ID

Public gists automatically include a footer noting they were generated by Claude Code and advising readers to verify the content.

License

MIT (see LICENSE file)