@practicaltools/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 Apify cloud actors.

Features

• reddit_fast_search: Quickly search for Reddit posts, comments, or users.
• reddit_lead_monitor: Find high-intent leads or brand mentions while filtering out noise.

🚀 Quick Links

Claude Desktop | Cursor IDE | Windsurf | VS Code | Claude Code

⚡️ Frictionless Installation (Recommended)

Since the package is published on NPM, you can install and run it without cloning the repository!

1. 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"
      }
    }
  }
}

2. Cursor IDE & Windsurf

• Open Settings -> MCP Servers.
• Add a new server:
  • Name: Reddit MCP
  • Type: stdio
  • Command: npx -y @practicaltools/reddit-mcp-server
  • Env: APIFY_API_TOKEN=YOUR_TOKEN

3. Claude Code (CLI)

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

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

• Sign up/Log in: Go to Apify Console.
• Navigate to Settings: Click the Settings icon in the bottom-left sidebar.
• Integrations Tab: Select the Integrations tab at the top.
• Copy Token: You will see your API Token at the top of the page. Copy this string.

🚀 Multi-Platform Setup

1. Claude Desktop (macOS/Windows)

Add this to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

2. Cursor IDE

• Open Settings -> Cursor Settings.
• Go to Features -> MCP Servers.
• Click + Add New MCP Server.
• Set:
  • Name: Reddit MCP
  • Type: stdio
  • Command: npx -y @practicaltools/reddit-mcp-server
  • Env: Key=APIFY_API_TOKEN, Value=YOUR_TOKEN

3. Windsurf

• Open Settings -> MCP.
• Click Add Server.
• Set Command: npx -y @practicaltools/reddit-mcp-server
• Add Environment Variable: APIFY_API_TOKEN=YOUR_TOKEN

4. VS Code (GitHub Copilot Agent Mode)

• Ensure you have the GitHub Copilot Chat extension installed.
• Create/Update .vscode/mcp.json:

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

5. Claude Code (CLI)

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

6. ChatGPT & Lovable (via Bridge)

ChatGPT and Lovable do not natively support external MCP servers yet. To use them, you can use a bridging tool like mcp-bridge which exposes the tools as GPT Actions or a local API that Lovable can interact with.

7. Antigravity & Agentic Frameworks

To use this server with agentic coding assistants like Antigravity, simply use the npx command in your agent's configuration. The agent will then be able to call reddit_fast_search and reddit_lead_monitor directly.

🛠 Local Development

If you want to run the server from source:

# 1. Install dependencies
npm install

# 2. Build for production (Generates dist/index.js)
npm run build

# 3. Running locally
node dist/index.js

Usage Tips

• Search Reddit: "Search Reddit for 'Best budget keyboards' in r/MechanicalKeyboards"
• Find Leads: "Monitor Reddit for people looking for 'Logo Design' in the last 24 hours."