Install Reddit MCP Server

Pick your client, copy the command, done.

claude mcp add reddit-mcp-server -- uvx reddit-no-auth-mcp-server

Environment Variables

Set these before running Reddit MCP Server.

VariableDescriptionRequired

REDDIT_TRANSPORTMCP transport (stdio, streamable-http)No

REDDIT_HOSTHost for HTTP transportNo

REDDIT_PORTPort for HTTP transportNo

REDDIT_PATHPath for HTTP transportNo

REDDIT_LOG_LEVELLog level (DEBUG, INFO, WARNING, ERROR)No

REDDIT_PROXYHTTP/HTTPS proxy URLNo

REDDIT_TIMEOUTRequest timeout in secondsNo

REDDIT_THROTTLE_MINMin delay between paginated requestsNo

REDDIT_THROTTLE_MAXMax delay between paginated requestsNo

Once configured, Reddit MCP Server gives your AI agent access to:

searchSearch all of Reddit for posts matching a query.

querylimitsort

search_subredditSearch within a specific subreddit.

subredditquerylimitsort

get_postGet full details of a Reddit post including its comment tree.

permalink

get_subreddit_postsGet posts from a subreddit listing.

subredditlimitcategorytime_filter

get_userGet a user's recent public activity (posts and comments).

usernamelimit

get_user_postsGet a user's submitted posts.

usernamelimitcategorytime_filter

After setup, try these prompts with your AI agent:

→Search for recent discussions about 'async programming' in the Python subreddit.

→Get the top posts from the MachineLearning subreddit for the past week.

→Retrieve the full comment tree for the Reddit post at /r/Python/comments/abc123/my_post/.

→Show me the recent activity and posts from the user 'spez'.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed

Alternative installation methods

git clone https://github.com/eliasbiondo/reddit-mcp-server.git && cd reddit-mcp-server && uv sync

Conare · memory for coding agents

Save the docs, env vars, and workflow around Reddit MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.