Reddit MCP server

CommunityJordan Burke115Config last verified Jun 1, 2026

A maintained MCP server that lets agents read and post Reddit content — posts, comments, users, and subreddits via the official API.

This Reddit MCP server is an actively maintained, community-built server that connects an AI agent to Reddit through Reddit's official API. On the read side it can fetch a specific post with engagement analysis, pull top posts from a subreddit or the home feed, browse a subreddit by sort method (hot, new, top, rising, controversial), retrieve user profiles, posts, and comments, look up subreddit statistics, list trending subreddits, get a post's threaded comments, and run a free-text search across Reddit. That makes it a useful tool for sentiment research, trend tracking, community monitoring, and grounding answers in real discussion rather than memorized facts.

It also ships a full set of write tools — create a post, reply to a post or comment, edit your own post or comment, and delete your own post or comment — that act on behalf of an authenticated Reddit user. The server is published as the reddit-mcp-server npm package and runs locally over stdio via npx. Read operations need a REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET from a registered Reddit app; write operations additionally require REDDIT_USERNAME and REDDIT_PASSWORD. It can also run as an HTTP service (TRANSPORT_TYPE=httpStream) if you prefer to host it. Because the write tools mutate live community content, keep them behind review.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "reddit-mcp-server"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<REDDIT_CLIENT_ID>",
        "REDDIT_CLIENT_SECRET": "<REDDIT_CLIENT_SECRET>",
        "REDDIT_USERNAME": "<REDDIT_USERNAME>",
        "REDDIT_PASSWORD": "<REDDIT_PASSWORD>"
      }
    }
  }
}
Or via CLI
bash
claude mcp add reddit -- npx -y reddit-mcp-server

Available tools

ToolDescription
get_reddit_postRetrieves a specific Reddit post with engagement analysis.
get_top_postsFetches the top posts from a subreddit or the home feed.
browse_subredditBrowses a subreddit by sort method (hot, new, top, rising, controversial).
get_user_infoRetrieves detailed information about a Reddit user.
get_user_postsGets the posts submitted by a given user.
get_user_commentsGets the comments made by a given user.
get_subreddit_infoRetrieves a subreddit's details and statistics.
get_trending_subredditsGets the currently trending subreddits.
get_post_commentsGets a post's comments with their threading.
search_redditSearches for posts across Reddit.
create_postCreates a new post in a subreddit (requires user credentials).
reply_to_postPosts a reply to an existing post or comment (requires user credentials).
edit_postEdits your own Reddit post's self-text (requires user credentials).
edit_commentEdits your own Reddit comment (requires user credentials).
delete_postPermanently deletes your own post (requires user credentials).
delete_commentPermanently deletes your own comment (requires user credentials).

Required configuration

  • REDDIT_CLIENT_IDRequired

    Client ID of a registered Reddit app.

  • REDDIT_CLIENT_SECRETRequired

    Client secret of the registered Reddit app.

  • REDDIT_USERNAMEOptional

    Reddit username, needed only for write operations.

  • REDDIT_PASSWORDOptional

    Reddit password, needed only for write operations.

What you can do with it

Track sentiment and trends

An agent searches Reddit and browses relevant subreddits to gauge how a community is reacting to a product, release, or topic, surfacing real discussion instead of guessing.

Engage on your behalf

With user credentials supplied, the agent can draft and post a reply or new submission, keeping the mutating action behind a review step you control.

FAQ

Is it free?
Yes. The server is open source under the MIT license, and Reddit's API has a free tier. You must register a Reddit app to get a client ID and secret; heavy usage is subject to Reddit's API rate limits and terms.
Does it support remote/OAuth?
It runs locally over stdio via npx and can also run as an HTTP service (TRANSPORT_TYPE=httpStream). It authenticates to Reddit with app credentials (and username/password for writes) rather than a hosted OAuth endpoint.
Can it post and delete content?
Yes, if you supply a Reddit username and password. The write tools can create posts, reply, edit, and delete your own content. Because these change live community data, keep them behind review where possible.
← Browse all search-and-data servers