Reddit MCP Buddy

by karanb192

9.5k downloads Not rated yet

GitHub Website

About

Browse Reddit directly in Claude Desktop without API keys. Search posts, view subreddits, analyze users, and explore comments seamlessly. Features smart caching, rate limiting, and works instantly with zero configuration.

Explore

- 🔐 No API Keys Required - Works in anonymous mode out of the box
- ⚡ Smart Caching - Faster responses with intelligent cache management
- 🛡️ Rate Limiting - Respects Reddit's servers automatically
- 📊 Three Authentication Modes:
- Anonymous: 10 req/min (default)
- App-only: 60 req/min (with client ID/secret)
- Authenticated: 100 req/min (full credentials)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Reddit MCP Buddy

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

From the repository

``bash npm install -g reddit-mcp-buddy`Add to your Claude Desktop config and restart. That's it!

`"What's trending on r/technology?" "Search for discussions about AI on Reddit" "Show me the top posts from r/science this week" "Analyze user spez" "What does 'AMA' mean on Reddit?"

json

  {

    "mcpServers": {

      "reddit-mcp-buddy": {

        "command": "reddit-mcp-buddy",

        "env": {

          "REDDIT_CLIENT_ID": "your_client_id",

          "REDDIT_CLIENT_SECRET": "your_client_secret",

          "REDDIT_USERNAME": "your_username",

          "REDDIT_PASSWORD": "your_password"

        }

      }

    }

  }

  

bash

  npm install -g reddit-mcp-buddy

  

bash

  npx reddit-mcp-buddy

`browse_subreddit`

Fetch posts from a subreddit sorted by your choice (hot/new/top/rising/controversial). Returns a post list with content, metadata, and a data_source field. With Reddit credentials (data_source "api") posts include score, num_comments, and upvote_ratio; without credentials, results come from Reddit's public RSS feed (data_source "rss") and those fields plus nsfw are null — see the response note and do not infer popularity from them.

`search_reddit`

Search for posts across Reddit or specific subreddits. Returns matching posts with content and metadata.

`get_post_details`

Fetch a Reddit post with its comments. Requires EITHER url OR post_id. IMPORTANT: When using post_id alone, an extra API call is made to fetch the subreddit first (2 calls total). For better efficiency, always provide the subreddit parameter when known (1 call total).

`user_analysis`

Analyze a Reddit user's posting history, karma, and activity patterns. Returns posts, comments, and statistics.

`reddit_explain`

Get explanations of Reddit terms, slang, and culture. Returns definition, origin, usage, and examples.

| Tool | Description |
|------|-------------|
| browse_subreddit | Fetch posts from any subreddit with sorting options |
| search_reddit | Search across Reddit with filters |
| get_post_details | Get full post content with comments |
| user_analysis | Analyze Reddit user profiles |
| reddit_explain | Explain Reddit terms and culture |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "reddit mcp buddy": {
            "reddit-mcp-buddy": {
                "command": "npx",
                "args": [
                    "reddit-mcp-buddy"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "",
                    "REDDIT_CLIENT_SECRET": "",
                    "REDDIT_USERNAME": "",
                    "REDDIT_PASSWORD": ""
                }
            }
        }
    }
}

McpServers

{
    "reddit-mcp-buddy": {
        "command": "npx",
        "args": [
            "reddit-mcp-buddy"
        ],
        "env": {
            "REDDIT_CLIENT_ID": "",
            "REDDIT_CLIENT_SECRET": "",
            "REDDIT_USERNAME": "",
            "REDDIT_PASSWORD": ""
        }
    }
}

Browse Reddit content directly within Claude Desktop - no tab switching, no API keys required! ## 🚀 Quick Start ``

bash
  npm install -g reddit-mcp-buddy



  Add to your Claude Desktop config and restart. That's it!

  ## ✨ Features

  ### Core Functionality
  - Browse Subreddits - Access any subreddit with hot/new/top/rising/controversial sorting
  - Search Reddit - Full-text search across all of Reddit or specific subreddits
  - View Posts & Comments - Get complete post details with nested comment threads
  - Analyze Users - View posting history, karma, and activity patterns
  - Explain Reddit Terms - Understand Reddit culture and terminology

  ### Technical Features
  - 🔐 No API Keys Required - Works in anonymous mode out of the box
  - ⚡ Smart Caching - Faster responses with intelligent cache management
  - 🛡️ Rate Limiting - Respects Reddit's servers automatically
  - 📊 Three Authentication Modes:
    - Anonymous: 10 req/min (default)
    - App-only: 60 req/min (with client ID/secret)
    - Authenticated: 100 req/min (full credentials)

  ## 💬 Example Usage in Claude


  "What's trending on r/technology?"
  "Search for discussions about AI on Reddit"
  "Show me the top posts from r/science this week"
  "Analyze user spez"
  "What does 'AMA' mean on Reddit?"



  ## 🔧 Configuration

  ### Basic (Anonymous Mode)

json
  {
    "mcpServers": {
      "reddit-mcp-buddy": {
        "command": "reddit-mcp-buddy"
      }
    }
  }



  ### Advanced (With Authentication)

json
  {
    "mcpServers": {
      "reddit-mcp-buddy": {
        "command": "reddit-mcp-buddy",
        "env": {
          "REDDIT_CLIENT_ID": "your_client_id",
          "REDDIT_CLIENT_SECRET": "your_client_secret",
          "REDDIT_USERNAME": "your_username",
          "REDDIT_PASSWORD": "your_password"
        }
      }
    }
  }



  ## 📦 Installation Methods

  ### Global Install (Recommended)

bash
  npm install -g reddit-mcp-buddy



  ### NPX (No Install)

bash
  npx reddit-mcp-buddy



  ### From Source

bash
  git clone https://github.com/karanb192/reddit-mcp-buddy.git
  cd reddit-mcp-buddy
  npm install
  npm run build
  npm start



  ## 🛠️ Available Tools

  | Tool | Description |
  |------|-------------|
  |

browse_subreddit

 | Fetch posts from any subreddit with sorting options |
  |

search_reddit

 | Search across Reddit with filters |
  |

get_post_details

 | Get full post content with comments |
  |

user_analysis

 | Analyze Reddit user profiles |
  |

reddit_explain` | Explain Reddit terms and culture | ## 📊 Performance - Response Time: <1s for most queries - Cache TTL: 15 min (anonymous), 5 min (authenticated) - Rate Limits: Automatic handling based on auth level - Memory Usage: <50MB typical ## 🔗 Links - GitHub: reddit-mcp-buddy - NPM: reddit-mcp-buddy - Issues: Report bugs ## 📄 License MIT © Karan Bansal ## 🌟 Why Reddit MCP Buddy? - Zero Config: Works immediately after install - No API Keys: Anonymous mode for instant access - Smart Defaults: Optimized for Claude's context window - Active Development: Regular updates and improvements - Open Source: Fully transparent and auditable Perfect for researchers, content creators, community managers, and anyone who wants Reddit data in their AI workflow!

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

browse_subreddit

search_reddit

get_post_details

user_analysis

reddit_explain

Claude Desktop / Cursor

McpServers

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

`browse_subreddit`

`search_reddit`

`get_post_details`

`user_analysis`

`reddit_explain`