io.github.mypracticaltools/reddit-mcp-server

Reddit MCP Server 🤖

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:

Claude Desktop (macOS/Windows)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "npx",
      "args": ["-y", "@practicaltools/reddit-mcp-server"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

Cursor & Windsurf

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

Claude Code (CLI)

claude-code --mcp @practicaltools/reddit-mcp-server="npx -y @practicaltools/reddit-mcp-server" --env APIFY_API_TOKEN=YOUR_TOKEN

VS Code (Copilot Agent)

Add to .vscode/mcp.json:

{
  "mcpServers": {
    "reddit-mcp": {
      "command": "npx",
      "args": ["-y", "@practicaltools/reddit-mcp-server"],
      "env": { "APIFY_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

🔑 Getting Your Apify API Token

To use this server, you need an Apify API token.

1. Sign up/Log in: Apify Console.
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:

# Install dependencies
npm install

# Build the project
npm run build

# Run locally
node dist/index.js

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

Built with ❤️ by Practical Tools