mcp-server-gist

What is mcp-server-gist?

mcp-server-gist is a Model Context Protocol (MCP) server that wraps the GitHub Create a Gist API as a single MCP tool. It allows AI assistants or any MCP client to programmatically create Gists on a GitHub account using a fine-grained personal access token.

How to use mcp-server-gist?

Configure the server in your MCP client by pointing to its build/index.js file with Node.js and setting the GITHUB_GIST_TOKEN environment variable to your GitHub token. Once connected, invoke the create-gist tool with the required inputs: gistContent (string), isPublic (boolean, defaults to false), and an optional filename (string, auto-generated if omitted). The tool returns the URL of the newly created Gist.

Key features of mcp-server-gist

• Creates a Gist via the GitHub API.
• Supports both public and secret Gists.
• Automatically generates a filename if not provided.
• Returns the URL of the created Gist.
• Uses a fine-grained personal access token for authentication.

Use cases of mcp-server-gist

• An AI coding assistant shares code snippets as public Gists.
• A workflow tool saves logs or outputs as secret Gists.
• A developer integrates Gist creation into an MCP-based agent pipeline.

FAQ from mcp-server-gist

What does mcp-server-gist do?

It provides a single MCP tool (create-gist) that creates a Gist on your GitHub account. No other Gist operations (read, update, delete) are supported.

What is required to use mcp-server-gist?

You need Node.js to run the server and a GitHub personal access token (fine-grained) stored in the environment variable GITHUB_GIST_TOKEN.

How do I get a GitHub token for mcp-server-gist?

Follow GitHub’s guide to create a fine-grained personal access token with permission to create Gists (see the README link). Set the token as the GITHUB_GIST_TOKEN environment variable.

Can mcp-server-gist update or delete existing Gists?

No. The server only wraps the “Create a Gist” API endpoint. It does not provide tools to modify or remove existing Gists.

Where are the created Gists stored?

Gists are stored on GitHub under the account associated with the token. The server does not store any data locally beyond the token configuration.