Skip to main content
Stay on top of the conversations that matter, discover emerging trends, and even publish directly to Reddit - all without touching the Reddit API. With the Reddit integration you can search subreddits, pull rich post data, manage comments, and create or edit posts using nothing more than natural language prompts.
Tap into the global Reddit community of over 430 million monthly users and 100k+ active subreddits - perfect for monitoring niches, gathering insights, and engaging in real time.

​
Important: Bring Your Own Reddit App (MCP Only)

Reddit MCP nodes require you to bring your own Reddit app credentials. This requirement applies only to Reddit MCP nodes, not the native Reddit Scraper.

Just need read-only access?

If you only need to fetch posts, comments, or search subreddits, use the Reddit Scraper node instead. It works out of the box without any custom credentials and is easier to set up.

​
Background

Reddit’s Responsible Builder Policy requires applications to be individually reviewed and limits the use of shared developer credentials. As a result, Reddit MCP nodes use a “bring your own Reddit app” model. This gives you direct control over your API access and ensures compliance with Reddit’s policies. Important: This credential requirement applies only to Reddit MCP nodes. The native Reddit Scraper node works without any custom credentials for read-only operations like fetching posts and comments.

​
What You Need to Do

To use Reddit MCP nodes, you must:
  1. Create or obtain access to a Reddit application with API credentials
  2. Add your Reddit client ID and secret to your Gumloop credentials
  3. Select your Reddit credentials when using Reddit MCP nodes
Reddit has temporarily restricted new app creation. Many users are currently unable to create new Reddit apps through the standard process. See the Reddit community discussion for updates, or request access through Reddit’s enterprise process below.

​
Setting Up Custom OAuth

​
Before You Begin

Make sure you have:
  • A Reddit account
  • Access to your Gumloop Credentials page
  • Permission to create or access Reddit app credentials for your organization
1

Create a Reddit Application

Visit Reddit’s app preferences and scroll to the bottom. Click “create another app…” under “Developed Applications.”If you cannot create an app, skip to the Enterprise API Access section below.
2

Configure Your App

Fill in the application details:
  • Name: Enter a descriptive name (e.g., “My Company - Gumloop Integration”)
  • App type: Select “web app”
  • Description: Optional - describe your use case
  • About URL: Optional - your company website
  • Redirect URI: Enter https://www.gumloop.com/api/oauth/callback
Click “create app” to save.
3

Copy Your Credentials

After creating the app, locate your credentials:
  • Client ID: The string displayed directly under your app name (looks like a random string of characters)
  • Client Secret: Click “edit” on your app, then find the “secret” field
Copy both values - you’ll need them in the next step.
4

Add Credentials to Gumloop

  1. Go to your Gumloop Credentials page
  2. Click “Add Credential” and select “Reddit”
  3. Paste your Client ID and Client Secret into the corresponding fields
  4. Click “Save” to store your credentials
5

Verify Your Connection

Create a simple Reddit MCP node (e.g., “Fetch the top 3 posts from r/test”) and run it. If you see post data returned, your connection is working correctly.

​
Enterprise API Access

For organizations that cannot create Reddit apps through the standard process, or for high-volume use cases, Reddit offers an enterprise API request process:

Request Enterprise API Access

Submit a request to Reddit for enterprise-level API access. This is the recommended path for larger organizations or when standard app creation is unavailable.
 When submitting your request, be prepared to provide:
  • Your organization’s name and website
  • A description of your intended use case (mention Gumloop integration)
  • Expected API usage volume
  • Contact information for your technical team
Gumloop cannot grant Reddit API access or expedite Reddit’s approval process. Approval timelines and eligibility are determined entirely by Reddit.

​
Frequently Asked Questions

Reddit has temporarily restricted new app creation. You have two options: (1) Wait for Reddit to restore self-service app creation - check the Reddit community discussion for updates, or (2) Request enterprise API access through Reddit’s official form.
Existing workflows will only work if they are backed by valid Reddit app credentials. If your workflows are experiencing authentication errors, you’ll need to configure custom OAuth credentials as described above.
Typically, your IT administrator or the person responsible for third-party integrations should submit the enterprise API request. They’ll need to provide organizational details and agree to Reddit’s API terms.
Reddit’s Responsible Builder Policy requires applications to be individually reviewed. This policy change affects all third-party integrations, not just Gumloop.

​
How to Use MCP Nodes

​
What is Reddit MCP?

When you create a Reddit MCP node, Gumloop automatically builds a custom node that understands Reddit’s API. Just describe what you want in plain English and the node handles authentication, endpoints, and formatting behind the scenes. You can then reuse that node anywhere in your workflows.

​
What Can It Do for You?

  • Pull the hottest, newest, or top posts from any subreddit in seconds
  • Drill into a specific post to grab full text, score, author, and more
  • Publish, edit, or delete posts and comments without leaving Gumloop
  • Search across subreddits, posts, or user profiles to surface exactly what you need

​
Available Tools

ToolWhat It DoesExample Use
Retrieve Reddit PostFetch top posts in a subreddit with an optional size limit”Fetch the top 10 hot posts from r/programming and return title, score, and permalink”
Get Reddit Post DetailsGet detailed content about a specific Reddit post”Get details for post with URL reddit.com/r/tech/comments/[post_id] and return title, author, body_text, score, and comment_count”
Create Reddit PostPublish a new post in a chosen subreddit”Create a text post in r/learnpython titled ‘Best resources for beginners?’ with body ‘[question_details]’. Return post_id and URL”
Fetch Post CommentsRetrieve comments from a given post”Get the 20 newest comments for post titled ‘Weekly Discussion Thread’ in r/stocks and return author, body_text, and score”
Edit Reddit PostUpdate the content of an existing post”Edit my post titled ‘Looking for feedback on my app’ in r/startups - add ‘EDIT: Thanks for all the suggestions!’ to body. Return status”
Create Reddit CommentAdd a comment to a specific post”Comment ‘Great explanation, thanks!’ on the top post in r/explainlikeimfive and return comment_id and status”
Edit Reddit CommentUpdate an existing comment”Edit my latest comment in r/webdev - add ‘EDIT: Fixed the typo in the code’ to text. Return status”
Delete Reddit PostRemove a post you own”Delete my post titled ‘Test post please ignore’ from r/test and confirm deletion_status”
Delete Reddit CommentRemove a comment you own”Delete my comment containing ‘duplicate answer’ from r/askscience and return deletion_status”
Search SubredditsFind subreddits by name or description”Search subreddits about ‘machine learning’ and return subreddit_name, subscribers, and description”
Search PostsSearch posts across Reddit or within a specific subreddit”Search posts in r/datascience for ‘pandas vs polars’, limit 25, return title, subreddit, and permalink”
Search UsersDiscover users by profile text”Search users with ‘data scientist’ in their bio and return username, karma, and account_created_date”

​
How to Use

1

Create Your Reddit MCP Node

Go to your node library, search for Reddit, and click “Create a node with AI”
2

Add Your Prompt

Drag the Reddit MCP node to your canvas and add your prompt in the text box.
3

Test Your Node

Run the node to see the results. If it works as expected, you’re all set! If you run into issues, check the troubleshooting tips below.
4

Save and Reuse

Once your Reddit MCP node is working, save it to your library. You can now use this customized node in any workflow.

​
Example Prompts

Here are some prompts that work well with Reddit MCP: 
Fetch the top 5 hot posts from r/marketing and return title, score, and permalink

For `Post URL`, return title, author, body_text, score, and comment_count

Search subreddits about "digital nomad" and return subreddit_name, subscribers, and description

Get the 10 newest comments for `Post URL` and return author, body_text, and score

Search users with the phrase "data scientist" in their bio and return username, karma, and account_created_date
Start with a single, focused action and specify the exact fields you want back - this keeps runs fast and outputs tidy.

​
Troubleshooting

If your Reddit MCP node isn’t working as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “Fetch the top 3 hot posts from r/startups and return title and score”
  • Less efficient: “Fetch the top 10 posts from r/startups, summarize each one, then email the summaries to me”
For best results, keep Reddit MCP focused on one Reddit action, then pass the output to other nodes for summarization or emailing.

​
Match What Reddit Can Do

  • Good: “Delete Reddit post with Post URL”
  • Less efficient: “Delete the post and update a Google Sheet with the result”
Reddit MCP excels at Reddit actions. To update spreadsheets, follow up with Google Sheets Updater in your workflow.

​
Break Complex Tasks Into Steps

Trying to do too much in a single prompt might cause timeouts or unexpected errors: 
Search subreddits about AI, get the top 5 posts from each, summarize every post, and tweet the summaries
A more efficient approach is to split the work into smaller nodes:
1

Step 1: Find Subreddits

Search subreddits about AI and return subreddit_name and ID
2

Step 2: Get Posts

For each subreddit ID, fetch the top 5 posts and return post_id, title, and selftext
3

Step 3: Summarize Posts

Summarize each post using Ask AI and return a concise summary
4

Step 4: Publish Summaries

Send each summary via Tweet node with the post link
Connect these nodes sequentially in your workflow. The subreddit IDs from Step 1 feed into Step 2, post details from Step 2 feed into Step 3, and summaries from Step 3 go to Step 4.

​
Focus on Data Retrieval

Reddit MCP is great at getting information from Reddit. For analysis or content creation, pair it with other nodes. Example:
  • Good prompt: “Get Reddit post details for Post URL and return title, body_text, and score”
  • Less efficient: “Get post details and write a 500-word blog post about it”
Use Ask AI or another writing node for content creation. Keep Reddit MCP focused on retrieving or managing Reddit data.

​
Troubleshooting Node Creation

In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
In the node creation window, click “Request changes” and describe what you expected versus what you received.
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.

​
Troubleshooting API Access Issues

Reddit has temporarily restricted new app creation under their Responsible Builder Policy. Check the Reddit community discussion for updates on when app creation will be restored. In the meantime, enterprise customers can request API access directly from Reddit.
If you’re seeing authentication errors, ensure you’ve configured custom OAuth credentials in your Gumloop Credentials page. Reddit’s API now requires users to provide their own app credentials rather than using shared credentials.
Reddit enforces strict rate limits and access policies. If you’re hitting rate limits or receiving access denied errors, consider requesting enterprise API access from Reddit for higher limits. Enterprise customers should submit a request through Reddit’s official form.
If your previously working Reddit integration has stopped functioning, your credentials may have been revoked or expired. Re-authenticate by updating your credentials in the Gumloop Credentials page, or create a new Reddit app if needed.

​
Need More Help?