Loading...
GistPad MCP server manages GitHub Gists for personal knowledge, notes, and prompts, accessible via MCP-enabled AI clients. Supports read, write, and delete operations.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
GistPad MCP server manages GitHub Gists for personal knowledge, notes, and prompts, accessible via MCP-enabled AI clients. Supports read, write, and delete operations.
GistPad MCP offers convenient gist management but introduces risks due to write and delete capabilities. It's relatively safe if used with a narrowly scoped GitHub token and careful prompt management. Risky if the token is exposed or if prompts are not carefully vetted.
Performance depends on the number of gists and the size of individual gists. Listing and retrieving large gists may be slow. Caching is used to improve performance, but may require manual refreshing.
Cost is primarily related to GitHub API usage. Excessive use of the API may trigger rate limits. Consider the frequency of gist updates and the number of clients accessing the server.
{
"mcpServers": {
"gistpad": {
"command": "npx",
"args": ["-y", "gistpad-mcp"],
"env": {
"GITHUB_TOKEN": "<YOUR_PAT>"
}
}
}
}GITHUB_TOKENlist_gistsLists all of your non-archived and non-daily note gists.
Read-only operation, no side effects.
get_gistRetrieves the contents of a gist by its ID.
Read-only operation, no side effects.
create_gistCreates a new gist with a specified description and initial file contents.
Creates new content, but doesn't modify existing resources without explicit instruction.
delete_gistDeletes a gist by its ID.
Destructive operation, permanently removes data.
update_gist_descriptionUpdates a gist's description by its ID.
Modifies gist metadata, but not content.
duplicate_gistCreates a copy of an existing gist with all its files.
Creates new content based on existing content.
refresh_gistsReloads your gist lists, ignoring any cached data.
Read-only operation, no side effects.
update_gist_fileUpdates the contents of a specific file in a gist.
Modifies existing content.
add_gist_fileAdds a new file to an existing gist.
Adds new content to a gist.
delete_gist_fileDeletes a file from a gist.
Destructive operation, removes data from a gist.
rename_gist_fileRenames an existing file within a gist.
Modifies gist metadata, but not content.
edit_gist_fileMakes targeted find-and-replace edits to a gist file.
Modifies existing content.
list_gist_commentsLists all comments for a specified gist.
Read-only operation, no side effects.
add_gist_commentAdds a new comment to a gist.
Adds new content, but doesn't modify existing resources without explicit instruction.
edit_gist_commentUpdates the content of an existing comment.
Modifies existing content.
delete_gist_commentDeletes a comment from a gist.
Destructive operation, removes data.
get_todays_noteGets or creates today's daily note.
Creates new content if it doesn't exist, otherwise reads existing content.
update_todays_noteUpdates the content of today's daily note.
Modifies existing content.
list_daily_notesLists all of your daily notes.
Read-only operation, no side effects.
get_daily_noteGets the contents of a specific daily note by date.
Read-only operation, no side effects.
delete_daily_noteDeletes a specific daily note by date.
Destructive operation, removes data.
list_starred_gistsLists all your starred gists.
Read-only operation, no side effects.
star_gistStars a specific gist by ID.
Modifies gist metadata, but not content.
unstar_gistUnstars a starred gist by ID.
Modifies gist metadata, but not content.
list_archived_gistsLists all of your archived gists.
Read-only operation, no side effects.
archive_gistArchives one of your gists.
Modifies gist metadata, but not content.
unarchive_gistUnarchives an archived gist.
Modifies gist metadata, but not content.
list_gist_promptsLists the prompts in your prompts collection.
Read-only operation, no side effects.
add_gist_promptAdds a new prompt to your prompts collection.
Creates new content, but doesn't modify existing resources without explicit instruction.
delete_gist_promptDeletes a prompt from your collection.
Destructive operation, removes data.
Token
gistGistPad MCP offers convenient gist management but introduces risks due to write and delete capabilities. It's relatively safe if used with a narrowly scoped GitHub token and careful prompt management. Risky if the token is exposed or if prompts are not carefully vetted.
Autonomy is determined by the client using the MCP server. GistPad MCP itself does not enforce any specific autonomy constraints beyond the permissions granted by the GitHub token.
Production Tip
Use a dedicated GitHub token with the minimum required `gist` scope to limit the impact of potential token compromise.
Only the `gist` scope is required.
Use the `refresh_gists` tool.
No, GistPad MCP is configured with a single GitHub token at a time.
Pass the `--daily`, `--starred`, `--archived`, or `--prompts` flags to the `gistpad-mcp` CLI.
Prompts are stored as markdown files in a gist called `💬 Prompts`.
GistPad MCP provides notifications when resources change, but the client must support resource subscriptions to take advantage of this feature.
GistPad MCP will likely return an error to the client. Consider reducing the frequency of gist updates or using caching.