reddit

This MCP server provides programmatic access to Reddit data via a Python-based MCP endpoint backed by PRAW. It exposes a suite of read-only tools for retrieving user info, post and comment histories, subreddit statistics, top posts, and search capabilities. For authenticated operations, it also supports actions like creating posts and replying to posts or comments, once you provide user credentials. You can connect external AI tools (such as Claude or Cursor) to the server through the MCP configuration, enabling structured queries like get_user_info, search_posts, or get_trending_subreddits and receiving organized, analysis-rich responses.

To use the server, configure your MCP client with the provided mcp.json snippet, supplying the path to your UV executable and the repository source location. Start the UV server using the specified directory and entry script (server.py). Once running, you can issue queries that map to the listed tools, such as get_top_posts for a subreddit, search_posts with a query string, or get_subreddit_stats for health metrics. If you provide Reddit API credentials, you can unlock authenticated tools like who_am_i, create_post, and reply_to_post to interact with Reddit content on behalf of the authenticated user.

Prerequisites:

• Python 3.8+ installed on the host
• Access to a running uv (Python MCP server runner)
• Reddit API credentials (client_id and client_secret), with optional username and password for authenticated operations
• Git to clone the repository

Installation steps:

1. Clone the repository:

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

2. Install dependencies (if any are specified in a requirements.txt or setup script in the project):

# example, adjust if the project uses a virtual environment or poetry
python3 -m pip install -r requirements.txt

3. Prepare Reddit API credentials by creating a Reddit app and obtaining client_id and client_secret. Optionally provide Reddit_USERNAME and Reddit_PASSWORD for authenticated operations.
4. Configure the MCP runner (UV) using the snippet below, replacing PATH_TO_UV and PATH_TO_SRC with your actual paths. Save this as your mcp.json in the appropriate location for your MCP client (Claude Desktop or Cursor):

{
  "mcpServers": {
    "reddit": {
      "command": "{{PATH_TO_UV}}", 
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}",
        "run",
        "server.py"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password"
      }
    }
  }
}

5. Start the MCP server via your MCP runner (UV) by pointing it to the configured directory containing server.py and the mcp.json file.
6. Verify that the server is reachable and begin issuing MCP requests to interact with Reddit data.

Tips and caveats:

• Use read-only credentials for standard queries to avoid unintended actions; authenticated credentials enable posting and commenting.
• Store Reddit API credentials securely; avoid committing them to version control.
• The mcp.json configuration uses placeholders PATH_TO_UV and PATH_TO_SRC—ensure these point to the correct executable and repository directory where server.py resides.
• If you encounter rate limits from Reddit, consider spacing requests or introducing caching on the client side, and ensure your Reddit app has appropriate access scopes.
• For Claude/Desktop or Cursor users, place the mcp.json in the recommended configuration path indicated in the README, and restart the respective application to discover Reddit as an available integration.