Skip to content
Back to search

gistpad-mcp

πŸ““ An MCP server for managing your personal knowledge, daily notes, and re-usable prompts via GitHub Gists

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lostintangent--gistpad-mcp/badge.svg)](/listings/lostintangent--gistpad-mcp)

HTML

<a href="/listings/lostintangent--gistpad-mcp"><img src="/api/listings/lostintangent--gistpad-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Using VS Code? 1. Install the [GistPad extension](https://aka.ms/gistpad) 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):

```json { "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?`

1. **Creating content** - `Create a new gist about <foo>` - `Update my <foo> gist to call out <bar>`

1. **Daily todos** - `What are my unfinished todos for today?` - `Add a new todo for <foo>`

1. **Collaboration** - `Add a comment to the <foo> gist saying <bar>` - `Give me a share URL for the <foo> gist` - `View my starred gists`

1. **Gist organization** - `Archive my gist about <foo>` - `Add a new <foo> file to the <bar> gist and migrate the <baz> 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 <foo>`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 152 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # πŸ““ GistPad MCP
  2. 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](https://aka.ms/gistpad) and [GistPad.dev](https://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).
  3. - πŸƒ [Getting started](#-getting-started)
  4. - πŸ› οΈ [Included tools](#️-included-tools)
  5. - πŸ“ [Included resources](#-included-resources)
  6. - πŸ’¬ [Reusable prompts](#-reusable-prompts)
  7. - πŸ’» [CLI reference](#-cli-reference)
  8. ## πŸƒ Getting started
  9. 1. Using VS Code?
  10. 1. Install the [GistPad extension](https://aka.ms/gistpad) and then reload VS Code
  11. > _Note: This requires VS Code 1.101.0+, so if you're on an older version, it's time to upgrade!_
  12. 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 πŸ’ͺ
  13. 1. Other MCP clients...
  14. 1. Generate a personal access token that includes _only_ the `gist` scope: https://github.com/settings/tokens/new
  15. 1. Add the equivalent of the following to your client's MCP config file (or via an "Add MCP server" GUI/TUI):
  16. ```json
  17. {
  18. "mcpServers": {
  19. "gistpad": {
  20. "command": "npx",
  21. "args": ["-y", "gistpad-mcp"],
  22. "env": {
  23. "GITHUB_TOKEN": "<YOUR_PAT>"
  24. }
  25. }
  26. }
  27. }
  28. ```
  29. Once your client it setup, you can start having fun with gists + MCP! πŸ₯³ For example, try things like...
  30. 1. **Exploring content**
  31. - `How many gists have I edited this month?`
  32. - `What's the summary of my <foo> gist?`
  33. 1. **Creating content**
  34. - `Create a new gist about <foo>`
  35. - `Update my <foo> gist to call out <bar>`
  36. 1. **Daily todos**
  37. - `What are my unfinished todos for today?`
  38. - `Add a new todo for <foo>`
  39. 1. **Collaboration**
  40. - `Add a comment to the <foo> gist saying <bar>`
  41. - `Give me a share URL for the <foo> gist`
  42. - `View my starred gists`
  43. 1. **Gist organization**
  44. - `Archive my gist about <foo>`
  45. - `Add a new <foo> file to the <bar> gist and migrate the <baz> content into it`
  46. 1. **Reusable prompts**
  47. - `Create a new prompt that searches the web ofor a specified manga series and then provides a summary about it`
  48. - `Delete my prompt about <foo>`
  49. ## πŸ› οΈ Included tools
  50. ### Gist management
  51. - `list_gists` - List all of your gists (excluding daily notes and archived gists).
  52. - `get_gist` - Get the contents of a gist by ID.
  53. - `create_gist` - Create a new gist with a specified description and initial file contents.
  54. - `delete_gist` - Delete a gist by ID.
  55. - `update_gist_description` - Update a gist's description by ID.
  56. - `duplicate_gist` - Create a copy of an existing gist with all its files.
  57. - `refresh_gists` - Reload your gist lists, ignoring any cached data.
  58. ### File management
  59. - `update_gist_file` - Update the contents of a specific file in a gist.
  60. - `add_gist_file` - Add a new file to an existing gist.
  61. - `delete_gist_file` - Delete a file from a gist.
  62. - `rename_gist_file` - Rename an existing file within a gist.
  63. - `edit_gist_file` - Make targeted find-and-replace edits to a gist file.
  64. ### Comments
  65. - `list_gist_comments` - List all comments for a specified gist.
  66. - `add_gist_comment` - Add a new comment to a gist.
  67. - `edit_gist_comment` - Update the content of an existing comment.
  68. - `delete_gist_comment` - Delete a comment from a gist.
  69. ## πŸ› οΈ Optional tools
  70. The following tool sets are disabled by default to keep the tool surface minimal. Enable them by passing the corresponding CLI flag.
  71. #### Daily notes (`--daily`)
  72. - `get_todays_note` - Get or create today's daily note.
  73. - `update_todays_note` - Update the content of today's daily note.
  74. - `list_daily_notes` - List all of your daily notes.
  75. - `get_daily_note` - Get the contents of a specific daily note by date.
  76. - `delete_daily_note` - Delete a specific daily note by date.
  77. #### Starring (`--starred`)
  78. - `list_starred_gists` - List all your starred gists.
  79. - `star_gist` - Star a specific gist by ID.
  80. - `unstar_gist` - Unstar a starred gist by ID.
  81. #### Archiving (`--archived`)
  82. - `list_archived_gists` - List all of your archived gists.
  83. - `archive_gist` - Archive one of your gists.
  84. - `unarchive_gist` - Unarchive an archived gist.
  85. #### Prompts (`--prompts`)
  86. - `list_gist_prompts` - List the prompts in your prompts collection.
  87. - `add_gist_prompt` - Add a new prompt to your prompts collection.
  88. - `delete_gist_prompt` - Delete a prompt from your collection.
  89. ## πŸ“ Included resources
  90. In addition to the above tools, the GistPad MCP server also exposes your gists as resources (using the `gist:///` URI scheme), which allows clients to read them without requiring tool execution.
  91. When you add/delete/duplicate a gist, or change a gist's description, then a notification will be provided to MCP clients, indicating that the list of resources have changed. And if your MCP client supports resource subscriptions, then you can subscribe to a specific gist and get notified when it's updated.
  92. Additionally, for MCP clients that support resource templates, GistPad also exposes a resource at `gist:///{gistId}/comments`, which allows querying the comments for a gist (without needing to execute the `list_gist_comments` tool).
  93. ### Resource configuration
  94. If you'd like to expose either your archived gists, starred gists, and/or daily notes as resources, then simply update your MCP server config to pass the `--archived`, `--starred`, and/or `--daily` flags to the `gistpad-mcp` CLI.
  95. ## πŸ’¬ Reusable prompts
  96. GistPad allows you to create and manage parameterized/reusable prompts that are stored as markdown files in a gist. You can manage prompts using the `add_prompt` and `delete_prompt` tool, by simply asking your MCP client to create/delete a prompt, with the specified contents/arguments you want.
  97. Behind the scenes, prompts are stored as markdown files in a gist called `πŸ’¬ Prompts` (which is automatically created by the `add_prompt` tool). The prompt files include their prompt as the body, and optionally, a description and arguments using front-matter. And if the prompt makes use of arguments, the body of the prompt should include `{{argument}}` placeholders, which will be replaced when the MCP client retrieves it.
  98. ## πŸ’» CLI Reference
  99. The `gistpad-mcp` CLI accepts the following optional flags:
  100. - `--archived` - Enable archive tools and include archived gists in resources
  101. - `--starred` - Enable starring tools and include starred gists in resources
  102. - `--daily` - Enable daily note tools and include daily notes in resources
  103. - `--prompts` - Enable prompt tools and MCP prompt handlers
  104. - `--markdown` - Filter gists to only those composed of Markdown files
  105. ## 🧰 Troubleshooting
  106. - <u>Not seeing a gist in your list?</u> The GistPad MCP server caches your gist list and updates it 1) anytime you make a change through the MCP server, or 2) every hour. However, if you add/edit/delete a gist using an external client, you may need to tell GistPad MCP to refresh itself (assuming it hasn't performed its hourly refresh yet). You can do this by triggering the `refresh_gists` tool (e.g. running `#refresh_gists` in VS Code Copilot chat).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.