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!_
1. 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 💪
1. Other MCP clients...
1. Generate a personal access token that includes _only_ the gist scope: https://github.com/settings/tokens/new
1. Add the equivalent of the following to your client's MCP config file (or via an "Add MCP server" GUI/TUI):
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 gist?
1. **Creating content**
- Create a new gist about
- Update my gist to call out
1. **Daily todos**
- What are my unfinished todos for today?
- Add a new todo for
1. **Collaboration**
- Add a comment to the gist saying
- Give me a share URL for the gist
- View my starred gists
1. **Gist organization**
- Archive my gist about
- Add a new file to the gist and migrate the content into it
1. **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
🛠️ 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.
- delete_daily_note - Delete a specific daily note by date.