reddit

This MCP server exposes a set of Reddit-related capabilities that let you read data from Reddit and, with proper credentials, post content. Read-only tools (accessible with client credentials) include retrieving detailed user info, analyzing top posts, obtaining subreddit statistics, and listing trending subreddits. Read-write tools (requiring a user-authenticated context) enable creating posts and adding replies to posts or comments, all with engagement-oriented insights prepared by the server. To use these tools, configure the MCP with the provided environment variables for Reddit API access and then call the corresponding tool endpoints through your MCP client or agent, selecting the appropriate function name (e.g., get_top_posts, create_post, or reply_to_post) as needed.

Prerequisites:

• Node.js installed on your machine (v14+ recommended)
• npm or yarn for package management
• A Reddit application configured to obtain client ID and client secret

Installation steps:

1. Clone the repository: git clone https://github.com/alexandros-lekkas/reddit-mcp-server
2. Install dependencies: npm install
3. Create a Reddit app to obtain CLIENT_ID and CLIENT_SECRET by following Reddit's app creation page and selecting the script type.
4. Create a .env file (optional if you plan to pass env vars directly) and populate with: REDDIT_CLIENT_ID=<your-client-id> REDDIT_CLIENT_SECRET=<your-client-secret> REDDIT_USERNAME=<your-reddit-username> REDDIT_PASSWORD=<your-reddit-password>
5. Start the server in development mode: npm run dev
6. Verify the inspection server is running at http://127.0.0.1:6274/ and ensure connectivity with Reddit before adding MCP config.
7. In your MCP configuration, add the following (adjust paths to your environment):

  "mcpServers": {
    "reddit": {
      "command": "node",
      "args": [
        "path/to/reddit-mcp-server/build/index.js"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<your-client-id>",
        "REDDIT_CLIENT_SECRET": "<your-client-secret>",
        "REDDIT_USERNAME": "<your-username>",
        "REDDIT_PASSWORD": "<your-password>"
      },
      "autoApprove": [
        "get_reddit_post",
        "get_top_posts",
        "get_user_info",
        "get_subreddit_info",
        "get_trending_subreddits",
        "create_post",
        "reply_to_post"
      ]
    }
  }

Replace the placeholder values with your actual Reddit credentials and local path to the built index.js.

Tips and common issues:

• Ensure your Reddit app uses the script type and that you’ve granted the necessary scopes for reading and posting.
• Use environment variables to keep credentials out of your MCP config files; consider a secrets manager for production.
• If you only need read-only features, you can run the server with client credentials and omit password-related env vars.
• The inspection UI at http://127.0.0.1:6274/ helps verify endpoints and sample calls.
• If you encounter connection errors, confirm that the build/index.js path is correct after your build process and that Node has permission to access network resources.
• For posting actions, Reddit may require you to complete additional verification steps or rate limits; ensure your account has posting permissions.
• Keep dependencies updated to avoid compatibility issues with Reddit API changes.