Reddit Mcp Server

mypracticaltools/reddit-mcp-server

This server connects Claude to Reddit via Apify's cloud scraping actors, giving you two main tools: reddit_fast_search for general queries across posts, comments, and users, and reddit_lead_monitor for filtering high-intent mentions while cutting through noise. You'll need an Apify API token to run it, which makes sense since it's offloading the scraping work to their infrastructure rather than hitting Reddit directly. Reach for this when you want Claude to pull Reddit data without managing rate limits or parsing HTML yourself. Works with Claude Desktop, Cursor, Windsurf, and VS Code via stdio transport.

GitHub stars: 8
tools: 10
auth: Secret needed
transport: STDIO
env var: 1
last updated: Jan 12, 2026

View on GitHub

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

REDDIT_CREATE_REDDIT_POSTCreates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.6 params

Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.

Parameters* required

flair_idstring

Optional ID of the flair to apply to the post. Use the 'REDDIT_GET_USER_FLAIR' action to find available flair IDs for the specified subreddit. Omit this field entirely if no flair is needed.

kindstring

The type of the post. Use 'self' for a text-based post or 'link' for a post that links to an external URL.one of link · self

subredditstring

The name of the subreddit (without the 'r/' prefix) where the post will be submitted.

textstring

The markdown-formatted text content for a 'self' post. Required if `kind` is 'self'.

titlestring

The title of the post. Must be 300 characters or less.

urlstring

The URL for a 'link' post. Required if `kind` is 'link'.

REDDIT_DELETE_REDDIT_COMMENTDeletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.1 params

Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.

Parameters* required

idstring

The full 'thing ID' (fullname, e.g., 't1_c0s4w1c') of the comment to delete; typically starts with 't1_'.

REDDIT_DELETE_REDDIT_POSTPermanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.1 params

Permanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.

Parameters* required

idstring

The full name (fullname) of the Reddit post to be deleted. This ID must start with 't3_' followed by the post's unique base36 identifier.

REDDIT_EDIT_REDDIT_COMMENT_OR_POSTEdits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.2 params

Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.

Parameters* required

textstring

The new raw markdown text for the body of the comment or self-post.

thing_idstring

The full name (fullname) of the comment or self-post to edit. This is a combination of a prefix (e.g., 't1_' for comment, 't3_' for post) and the item's ID.

REDDIT_GET_USER_FLAIRFetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.1 params

Fetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.

Parameters* required

subredditstring

Name of the subreddit (e.g., 'pics', 'gaming') for which to retrieve available link flairs.

REDDIT_POST_REDDIT_COMMENTPosts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.2 params

Posts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.

Parameters* required

textstring

The raw Markdown text of the comment to be submitted.

thing_idstring

The ID of the parent post (link) or comment, prefixed with 't3_' for a post (e.g., 't3_10omtdx') or 't1_' for a comment (e.g., 't1_h2g9w8l').

REDDIT_RETRIEVE_POST_COMMENTSRetrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.1 params

Retrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.

Parameters* required

articlestring

Base-36 ID of the Reddit post (e.g., 'q5u7q5'), typically found in the post's URL and not including the 't3_' prefix.

REDDIT_RETRIEVE_REDDIT_POSTRetrieves the current hot posts from a specified, publicly accessible subreddit.2 params

Retrieves the current hot posts from a specified, publicly accessible subreddit.

Parameters* required

sizeinteger

The maximum number of posts to return. Default is 5. Set to 0 to retrieve all available posts (or the maximum allowed by the Reddit API for a single request, typically up to 100 for this type of li...default: 5

subredditstring

The name of the subreddit from which to retrieve posts (e.g., 'popular', 'pics'). Do not include 'r/'.

REDDIT_RETRIEVE_SPECIFIC_COMMENTRetrieves detailed information for a specific Reddit comment or post using its fullname.1 params

Retrieves detailed information for a specific Reddit comment or post using its fullname.

Parameters* required

idstring

Fullname of the comment or post to retrieve (e.g., 't1_c123456', 't3_x56789').

REDDIT_SEARCH_ACROSS_SUBREDDITSSearches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.4 params

Searches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.

Parameters* required

limitinteger

The maximum number of search results to return. Default is 5. Maximum allowed value is 100.default: 5

restrict_srboolean

If True (default), confines the search to posts and comments within subreddits. If False, the search scope is broader and may include matching subreddit names or other Reddit entities.default: true

search_querystring

The search query string used to find content across subreddits.

sortstring

The criterion for sorting search results. 'relevance' (default) sorts by relevance to the query. 'new' sorts by newest first. 'top' sorts by highest score (typically all-time). 'comments' sorts by...one of relevance · new · top · commentsdefault: relevance

Configuration

APIFY_API_TOKEN*secret

Your Apify API Token

Readme

Reddit MCP Server 🤖

An MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to high-performance Apify cloud actors.

🌟 Key Features

reddit_fast_search: Quickly search for Reddit posts, comments, or users. Best for general information gathering.
reddit_lead_monitor: Find high-intent leads or brand mentions while filtering out noise.

⚡️ Quick Install

Choose your platform to install Reddit MCP in seconds:

Claude Desktop (macOS/Windows)

Add this to your claude_desktop_config.json:

View the full README on GitHub

Details

Repository: github.com/mypracticaltools/reddit-mcp-server
Package: @practicaltools/reddit-mcp-server
Transport: STDIO
Auth: Required
Registry: MCP registry, active