Claude MarketplacesSubmit
jordanburke avatar

Reddit Mcp Server

jordanburke/reddit-mcp-server

Hooks Claude up to Reddit's API with full read and write permissions. You get the usual browsing tools like searching posts, pulling comments, checking user profiles, and scanning subreddits. The write side lets you create posts, reply to threads, edit your content, and delete things you've published. It includes spam protection out of the box with configurable safe mode that enforces delays between posts and blocks duplicate content to keep your account in good standing with Reddit's detection systems. Runs in anonymous mode for read-only work or authenticated mode when you need to post. Built-in bot disclosure footers help you stay compliant with Reddit's automation policies.

GitHub stars
320
tools
10
auth
Secret needed
transport
STDIO
env vars
8
last updated
Oct 31, 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

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

REDDIT_CLIENT_ID

Reddit app client ID (optional - live Reddit data; without it, reads come from RSS feeds and the Arctic Shift archive)

REDDIT_CLIENT_SECRETsecret

Reddit app client secret

REDDIT_USERNAME

Reddit username (required for write operations)

REDDIT_PASSWORDsecret

Reddit password (required for write operations)

REDDIT_AUTH_MODE

Authentication mode: auto or authenticated (anonymous is a deprecated alias for keyless)

REDDIT_SAFE_MODE

Write safeguards: off, standard (default), or strict

REDDIT_BOT_DISCLOSURE

Bot disclosure footer: auto or off (default)

REDDIT_BOT_FOOTER

Custom bot footer text (used with REDDIT_BOT_DISCLOSURE=auto)

Readme

Reddit MCP Server

A Model Context Protocol (MCP) server for interacting with Reddit - fetch posts, comments, user info, and create content.

npm version npm downloads GitHub stars License: MIT

reddit-mcp-server MCP server

Reddit is closing its public API

Reddit announced on 2026-09-30 that it is ending RSS feeds and its public Data API, and moving apps to its Developer Platform (r/redditdev post, r/modnews post):

View the full README on GitHub

Details

Repository
github.com/jordanburke/reddit-mcp-server
Category
Search & Web Crawling
Package
reddit-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from jordanburke

Related Search & Web Crawling MCP servers

View all
1workopia avatarWorkopia — Job Searchworkopia/workopia-mcpSearch 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.312stars
2aayoawoyemi avatarOri Memoryaayoawoyemi/ori-mnemosPersistent memory infrastructure for AI agents. Identity, knowledge graph, and search.0stars
3jsonallen avatarPerplexityjsonallen/perplexity-mcpA Model Context Protocol (MCP) server that provides web search functionality using Perplexity AI's API.300stars
4burningion avatarVideo Editing Mcpburningion/video-editing-mcpMCP Server for Video Jungle - Analyze, Search, Generate, and Edit Videos273stars
5orneryd avatarMimirorneryd/mimirProvides a persistent graph-based memory and task management for AI agents with MCP API access and semantic search.273stars
6nirholas avatarthree.ws Loomnirholas/three.wsBrowse the community 3D-creation gallery, fetch a creation with its viewer URL, and submit it.269stars