Reddit MCP Buddy

by karanb192

471 downloads

Not rated

GitHub

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.

Details

Author: karanb192
Downloads: 471
Categories: Other, Search, API

- Browse any subreddit with hot/new/top/rising/controversial sorting.
- Full-text search across all of Reddit or specific subreddits.
- View complete post details with nested comment threads.
- Analyze user profiles including posting history and karma.
- Explain Reddit terms and culture (like ‘AMA’).
- No API keys required; anonymous mode works out of the box.

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

Install the package globally using npm install -g reddit-mcp-buddy and add the MCP server configuration to your Claude Desktop settings. After restarting Claude, you can use natural language queries such as “What’s trending on r/technology?” or “Search for discussions about AI on Reddit.”

`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.

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": ""
        }
    }
}

Reddit MCP Buddy

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

Details

Jump to

Setting up with Highlight

From the repository

browse_subreddit

search_reddit

get_post_details

user_analysis

reddit_explain

Claude Desktop / Cursor

McpServers

Reddit MCP Buddy

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

GitLab

`browse_subreddit`

`search_reddit`

`get_post_details`

`user_analysis`

`reddit_explain`