MCP Server Github Gist README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the MCP Server Github Gist listing page.

MCP Server GitHub Gist — Manage Gists from Your AI Assistant

npm version npm downloads CI License: MIT

An MCP server to create, read, update, and search GitHub Gists without leaving your AI assistant. The official GitHub MCP server handles repos and issues — this one fills the Gist gap.

Code
You: "Save this code snippet as a gist called 'auth-middleware.ts'"
AI:  ✅ Created secret gist: https://gist.github.com/abc123

Works with Claude Desktop, Cursor, and VS Code Copilot.

MCP server GitHub Gist demo — creating and listing gists from Claude Desktop

Tools

ToolWhat it does
gist_listList your gists (paginated)
gist_getGet a gist by ID (includes file contents)
gist_createCreate a new gist (public or secret)
gist_updateUpdate description or file contents
gist_deleteDelete a gist
gist_starredList your starred gists
gist_starStar a gist
gist_unstarUnstar a gist

Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

config.json
{
  "mcpServers": {
    "github-gist": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-gist"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

With Cursor

Add to your .cursor/mcp.json:

config.json
{
  "mcpServers": {
    "github-gist": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-gist"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Authentication

Requires a GitHub personal access token with the gist scope.

  1. Go to GitHub Settings > Tokens
  2. Create a token with the gist scope
  3. Set it as GITHUB_TOKEN or GITHUB_PERSONAL_ACCESS_TOKEN environment variable

Examples

Ask your AI assistant:

  • "List my recent gists"
  • "Create a gist with this code snippet"
  • "Show me gist abc123"
  • "Update the description of gist abc123"
  • "Delete gist abc123"
  • "Star this gist"

Development

Terminal
npm install
npm test
npm run build

Author

Made by ofershap

LinkedIn GitHub


README built with README Builder

License

MIT © Ofer Shapira