📓 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

🏃 Getting started

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>

🛠️ Included tools

Gist management

• list_gists - List all of your gists (excluding daily notes and archived gists).
• get_gist - Get the contents of a gist by ID.
• create_gist - Create a new gist with a specified description and initial file contents.
• delete_gist - Delete a gist by ID.
• update_gist_description - Update a gist's description by ID.
• duplicate_gist - Create a copy of an existing gist with all its files.
• refresh_gists - Reload your gist lists, ignoring any cached data.

File management

• update_gist_file - Update the contents of a specific file in a gist.
• add_gist_file - Add a new file to an existing gist.
• delete_gist_file - Delete a file from a gist.
• rename_gist_file - Rename an existing file within a gist.
• edit_gist_file - Make targeted find-and-replace edits to a gist file.

Comments

• list_gist_comments - List all comments for a specified gist.
• add_gist_comment - Add a new comment to a gist.
• edit_gist_comment - Update the content of an existing comment.
• delete_gist_comment - Delete a comment from a gist.

🛠️ Optional tools

The following tool sets are disabled by default to keep the tool surface minimal. Enable them by passing the corresponding CLI flag.

Daily notes (--daily)

• get_todays_note - Get or create today's daily note.
• update_todays_note - Update the content of today's daily note.
• list_daily_notes - List all of your daily notes.
• get_daily_note - Get the contents of a specific daily note by date.
• `d

... View full README on GitHub