developer-toolsapi_key

Gist

GitHub Gist is a service provided by GitHub that allows users to share code snippets, notes, and other text-based content. It supports both public and private gists, enabling easy sharing and collaboration.

Verdict

The Gist MCP connects your team's Switchy workspace to GitHub Gists, letting you read, star, and manage code snippets without leaving chat. @mention it to fetch a gist by ID, check its commit history, list comments or forks, or verify if you've starred it. Useful for teams that share configuration files, onboarding scripts, or troubleshooting snippets in Gists and want quick access during standups or pairing sessions. Requires a GitHub personal access token with gist scope. Write operations (creating or editing gists) aren't supported—you'll still need the GitHub UI for that.

Common use cases

  • Retrieve onboarding scripts during new hire chat
  • Check commit history on shared config snippets
  • List forks of a team gist before merging
  • Verify starred gists for sprint retrospectives
  • Pull troubleshooting code into incident channels

Integration

Vendor
Gist
Category
developer-tools
Auth
API_KEY
Tools
13
Composio slug
gist

Tools

  • Check Gist Star

    Tool to check if a gist is starred. Use when you need to determine if the authenticated user has starred a specific gist.

  • Delete Gist Comment
    destructive

    Tool to delete a comment on a gist. Use when you have both the gist_id and comment_id and want to remove that comment. Example prompt: "Delete comment 42 from gist 'aa5a315d61ae9438b18d'".

  • Get Gist

    Tool to retrieve a specific gist by its ID. Use when you have a gist_id and need complete gist details.

  • Get Gist Comment

    Tool to get a specific comment on a gist. Use when you need to retrieve details of a particular comment given gist_id and comment_id.

  • Get Gist Revision

    Tool to retrieve a specific gist revision. Use when you need details of a past state for an existing gist by commit SHA.

  • List Gist Comments

    Tool to list comments on a gist. Use after confirming the gist_id to retrieve comments for a specific gist. Example: 'List comments for gist abc123'.

  • List Gist Commits

    Tool to list the commit history of a gist. Use after you have the gist ID to review its revisions.

  • List Gist Forks

    Tool to list forks of a gist. Use after obtaining a gist_id to retrieve all forks for the gist.

  • List Gists

    Tool to list the authenticated user's gists or all public gists if called anonymously. Use after setting a valid GitHub token in headers.

  • List Starred Gists

    Tool to list the authenticated user's starred gists. Use when you need to retrieve all gists the user has starred.

  • List User Gists

    Tool to list public gists for a specified GitHub user. Use when you have a username and need their gists.

  • Unstar Gist

    Tool to unstar a gist. Use after confirming the gist has been previously starred.

  • Update Gist Comment

    Tool to update a Gist comment. Use when you need to modify an existing comment after confirming the gist_id and comment_id.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Gist in the MCP directory and click Connect. 3. You'll be prompted to paste a GitHub personal access token—generate one at github.com/settings/tokens with the 'gist' scope enabled. 4. Paste the token into Switchy and click Authorize. 5. Open any Space and type '@Gist get gist [gist_id]' (replace [gist_id] with an actual ID like 'aa5a315d61ae9438b18d'). 6. If the MCP returns the gist content, the connection is live. 7. To invoke other tools, @mention Gist followed by your request—'list comments for gist [id]' or 'check if I starred gist [id]'. 8. The MCP reads existing gists and metadata but cannot create or edit them.

What teammates see: by default, memories from Gist are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Fetch Gist Content

@Gist get gist aa5a315d61ae9438b18d and show me the file contents and description
Open in a Space →

Review Gist Revisions

@Gist list commits for gist aa5a315d61ae9438b18d so I can see the revision history
Open in a Space →

Check Gist Comments

@Gist list comments for gist aa5a315d61ae9438b18d and summarize any open questions
Open in a Space →

Find Gist Forks

@Gist list forks of gist aa5a315d61ae9438b18d and tell me who created each fork
Open in a Space →

Verify Starred Status

@Gist check if I starred gist aa5a315d61ae9438b18d and let me know the result
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Gist list all comments on gist aa5a315d61ae9438b18d and show me which ones mention performance issues

Output

I found 7 comments on that gist. Three mention performance: • Comment by @dev-maria (2 days ago): 'The regex on line 47 is causing a 3s delay on large files' • Comment by @jsmith (5 days ago): 'Memory usage spikes to 2GB when processing the sample dataset' • Comment by @code-reviewer (1 week ago): 'Consider caching the parse results — I'm seeing repeated computation' The other 4 comments discuss syntax preferences and documentation updates. Would you like me to retrieve the full text of any specific comment?

Notes

This example shows the MCP fetching comment metadata, then the AI filtering and summarizing by topic. Requires read:gist scope. The MCP returns comment structure (author, timestamp, body); the AI performs the semantic filtering for 'performance issues'.

Prompt

@Gist create a new gist called 'API response schema' with a JSON file showing our user endpoint structure, make it public

Output

I've created a public gist titled 'API response schema' with one file: user-endpoint.json. The gist includes the JSON structure you described (id, email, created_at, profile fields). Gist URL: https://gist.github.com/youruser/f3a8b2c1d9e4567890ab The gist is public and immediately shareable. You can edit it directly on GitHub or ask me to update it by referencing the gist ID. Note: creating gists counts against your GitHub API rate limit (5000/hour for authenticated users).

Notes

Demonstrates gist creation with the MCP's write capability. Requires gist scope (write access). The AI generates the JSON content; the MCP handles the GitHub API call. Users should know that public gists are discoverable and cannot be made private later — only deleted.

Prompt

@Gist get the commit history for gist aa5a315d61ae9438b18d and summarize what changed between the first and current version

Output

This gist has 4 commits over 3 weeks: 1. Initial commit (3 weeks ago): Single Python file, 45 lines — basic CSV parser 2. Commit 2 (2 weeks ago): Added error handling for malformed rows 3. Commit 3 (10 days ago): Introduced pandas dependency, rewrote core logic 4. Current (2 days ago): Added CLI argument parsing Net change: The script evolved from a 45-line manual parser to a 120-line pandas-based tool with CLI support. The core parsing approach was completely rewritten in commit 3. Would you like me to retrieve the diff for any specific commit?

Notes

Showcases the MCP's ability to fetch revision history, paired with AI synthesis across commits. Useful for code archaeology or understanding gist evolution. The MCP provides commit SHAs and metadata; the AI infers the narrative arc. No write operations, so safe for exploratory queries.

Use-case deep-dives

Code snippet library for distributed team

When Gist MCP beats a shared Notion doc for reusable snippets

A 6-person engineering team spread across three time zones keeps losing track of their internal code snippets—regex patterns, config templates, SQL helpers—buried in Slack threads or stale wiki pages. The Gist MCP wins here because it treats snippets as versioned, forkable artifacts with real commit history. Your team can star the canonical versions, fork them for project-specific tweaks, and use List Gist Commits to audit who changed the database connection string last month. The trade-off: if your snippets need inline documentation longer than a few paragraphs, or you're managing more than 50 active snippets, a proper docs site with search will scale better. For teams under 10 people sharing 20-40 utility snippets, this MCP turns Gist into a lightweight snippet registry you can query from any Switchy workspace without leaving the conversation.

Customer support macro review workflow

Using Gist MCP to version-control support response templates

A 3-person support team at a SaaS startup maintains 15 canned responses for common customer questions—password resets, billing clarifications, feature explanations. They store these as public gists so the whole company can reference them, but tracking edits and reverting bad changes has been manual chaos. The Gist MCP solves this by exposing Get Gist Revision and List Gist Commits directly in Switchy: the team lead can audit who softened the refund policy language last week, roll back to a previous version, and check comments from the legal reviewer without opening GitHub. The boundary: if you need approval workflows or role-based editing (only managers can publish), Gist has no access control beyond public/secret. For small teams where trust is high and transparency matters more than permissions, this MCP makes your support macros auditable and forkable in under five minutes of setup.

Interview code challenge distribution

When Gist MCP streamlines technical interview prep at hiring scale

A 4-person startup hiring its first two engineers needs to send the same take-home coding challenge to 12 candidates over three weeks, then track which version each candidate received after the team tweaked the prompt twice mid-cycle. The Gist MCP handles this cleanly: create one secret gist per candidate using the current template, fork it when the prompt changes, and use List Gist Forks plus Get Gist Revision to confirm which commit SHA went to which applicant. The team can also List Gist Comments to leave internal notes on each submission without cluttering email. The limit: if you're hiring at 50+ candidates per quarter or need applicant tracking integration, a proper ATS will give you better reporting and compliance tooling. For early-stage teams running 10-20 technical screens a quarter, this MCP turns Gist into a lightweight interview asset manager you can query without switching tools.

Frequently asked

What does the Gist MCP let me do in Switchy?

It connects your GitHub Gists account so AI agents can read, star, and manage your code snippets directly in conversations. Agents can retrieve gist content, list comments and forks, check revision history, and delete comments—useful when you're debugging snippets or reviewing team contributions without leaving the chat.

Do I need a GitHub personal access token to connect Gist?

Yes. The Gist MCP uses API key authentication, which means you'll generate a GitHub personal access token with gist scope permissions. You paste that token into Switchy once during setup. No OAuth redirect—just copy the token from GitHub's developer settings and you're connected.

Can the Gist MCP create or edit gists for me?

No. The current toolset is read-heavy: you can retrieve gists, check stars, list comments and forks, view revisions, and delete comments. If you need to create new gists or update existing ones, use GitHub's web interface or CLI. The MCP focuses on inspection and light moderation, not authoring.

Why use this instead of just opening Gist in a browser tab?

Speed and context. An agent can pull gist content, scan commit history, and summarize comments in one prompt—no tab-switching or manual copy-paste. It's faster when you're triaging multiple snippets or want an AI to compare revisions. For one-off edits, the browser is still simpler.

Who on my team should connect the Gist MCP?

Whoever owns the GitHub account with the gists you want to query. Each Switchy user connects their own token, so agents see only the gists that user can access. If your team shares snippets across accounts, each person needs their own connection—there's no org-wide token pooling.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.