# Reddit MCP Server 🤖
[](https://www.npmjs.com/package/@practicaltools/reddit-mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://github.com/mypracticaltools/Reddit-MCP-Server/actions)
An MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to high-performance Apify cloud actors.
## 🌟 Key Features
- **`reddit_fast_search`**: Quickly search for Reddit posts, comments, or users. Best for general information gathering.
- **`reddit_lead_monitor`**: Find high-intent leads or brand mentions while filtering out noise.
---
## ⚡️ Quick Install
Choose your platform to install **Reddit MCP** in seconds:
<details>
<summary><b>Claude Desktop (macOS/Windows)</b></summary>
Add this to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"reddit-mcp": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": {
"APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
```
</details>
<details>
<summary><b>Cursor & Windsurf</b></summary>
1. Open **Settings** -> **MCP Servers**.
2. Add a new server:
- **Name**: `Reddit MCP`
- **Type**: `stdio`
- **Command**: `npx -y @practicaltools/reddit-mcp-server`
- **Env**: `APIFY_API_TOKEN=YOUR_TOKEN`
</details>
<details>
<summary><b>Claude Code (CLI)</b></summary>
```bash
claude-code --mcp @practicaltools/reddit-mcp-server="npx -y @practicaltools/reddit-mcp-server" --env APIFY_API_TOKEN=YOUR_TOKEN
```
</details>
<details>
<summary><b>VS Code (Copilot Agent)</b></summary>
Add to `.vscode/mcp.json`:
```json
{
"mcpServers": {
"reddit-mcp": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": { "APIFY_API_TOKEN": "YOUR_TOKEN" }
}
}
}
```
</details>
---
## 🔑 Getting Your Apify API Token
To use this server, you need an Apify API token.
1. **Sign up/Log in**: [Apify Console](https://console.apify.com/).
2. **Settings**: Click the **Settings** icon in the bottom-left sidebar.
3. **Integrations**: Select the **Integrations** tab at the top.
4. **Copy Token**: Copy the string at the top of the page.
---
## 🛠 Local Development
If you want to contribute or run from source:
```bash
# Install dependencies
npm install
# Build the project
npm run build
# Run locally
node dist/index.js
```
## 🤝 Contributing
Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## 📄 License
MIT License - see [LICENSE](LICENSE) for details.
---
<p align="center">
Built with ❤️ by <a href="https://github.com/mypracticaltools">Practical Tools</a>
</p>
