gistpad-mcp

An MCP server for managing and sharing your personal knowledge, daily notes, and reuseable prompts via GitHub Gists. It's a companion to the GistPad VS Code extension and GistPad.dev (for web/mobile), which allows you to access and edit your gists from any MCP-enabled AI product (e.g. GitHub Copilot, Claude Desktop).

• 🏃 Getting started
• 🛠️ Included tools
• 📁 Included resources
• 💬 Reusable prompts
• 💻 CLI reference

1. Using VS Code?

   1. Install the GistPad extension and then reload VS Code

      Note: This requires VS Code 1.101.0+, so if you're on an older version, it's time to upgrade!

   2. Open the GistPad tab and sign-in with your GitHub account. After that, you can begin using GistPad from Copilot chat (in Agent mode) without doing any extra setup or token management 💪

2. Other MCP clients...

   1. Generate a personal access token that includes only the gist scope: https://github.com/settings/tokens/new

   2. Add the equivalent of the following to your client's MCP config file (or via an "Add MCP server" GUI/TUI):

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

Once your client it setup, you can start having fun with gists + MCP! 🥳 For example, try things like...

1. Exploring content

   • How many gists have I edited this month?
   • What's the summary of my <foo> gist?

2. Creating content

   • Create a new gist about <foo>
   • Update my <foo> gist to call out <bar>

3. Daily todos

   • What are my unfinished todos for today?
   • Add a new todo for <foo>

4. Collaboration

   • Add a comment to the <foo> gist saying <bar>
   • Give me a share URL for the <foo> gist
   • View my starred gists

5. Gist organization

   • Archive my gist about <foo>
   • Add a new <foo> file to the <bar> gist and migrate the <baz> content into it

6. Reusable prompts

   • Create a new prompt that searches the web ofor a specified manga series and then provides a summary about it
   • Delete my prompt about <foo>