Reddit Mcp Server

by Arindam200

337 downloads

Not rated

GitHub

Other

About

The Reddit Mcp Server is a Model Context Protocol (MCP) implementation that allows AI assistants to access and interact with Reddit content via the Python Reddit API Wrapper (PRAW). It provides tools for reading public data and performing authenticated actions like posting and…

Details

Author: Arindam200
Downloads: 337
Categories: Other

- Get detailed user information with engagement analysis
- Fetch and analyze top posts from any subreddit
- Get comprehensive subreddit statistics and health metrics
- View trending subreddits with growth patterns
- Create strategic posts with timing recommendations
- Reply to posts and comments with engagement optimization
- AI-driven insights and smart response formatting

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 Server

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 server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_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 server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_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 server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_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 server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_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 server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

From the repository

Clone the repository and configure the MCP server in your Claude Desktop or Cursor configuration file. Provide your Reddit API credentials (client ID and secret, and optionally username/password) as environment variables. After restarting the application, the server’s tools become available to the AI assistant.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "reddit mcp server": {
            "reddit": {
                "command": "{{PATH_TO_UV}}",
                "args": [
                    "--directory",
                    "{{PATH_TO_SRC}}",
                    "run",
                    "server.py"
                ],
                "env": {
                    "REDDIT_CLIENT_ID": "your_client_id",
                    "REDDIT_CLIENT_SECRET": "your_client_secret",
                    "REDDIT_USERNAME": "your_username",
                    "REDDIT_PASSWORD": "your_password"
                }
            }
        }
    }
}

McpServers

{
    "reddit": {
        "command": "{{PATH_TO_UV}}",
        "args": [
            "--directory",
            "{{PATH_TO_SRC}}",
            "run",
            "server.py"
        ],
        "env": {
            "REDDIT_CLIENT_ID": "your_client_id",
            "REDDIT_CLIENT_SECRET": "your_client_secret",
            "REDDIT_USERNAME": "your_username",
            "REDDIT_PASSWORD": "your_password"
        }
    }
}

Reddit MCP Server

This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).

What is MCP?

The Model Context Protocol (MCP) is a standard for enabling AI assistants to interface with external services, tools, and data sources. This server implements the MCP specification to provide access to Reddit content.

To know more about MCP, Check this video

Features

Installation

1. Clone this repository

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

2. Connect to the MCP server

Copy the below json with the appropriate {{PATH}} values:

   {
     "mcpServers": {
       "reddit": {
         "command": "{{PATH_TO_UV}}", // Run which uv and place the output here
         "args": [
           "--directory",
           "{{PATH_TO_SRC}}", // cd into the repo, run pwd and enter the output here
           "run",
           "server.py"
         ],
         "env": {
           "REDDIT_CLIENT_ID": "your_client_id",
           "REDDIT_CLIENT_SECRET": "your_client_secret",
           "REDDIT_USERNAME": "your_username", // Optional for authenticated operations
           "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations
         }
       }
     }
   }

You can obtain Reddit API credentials by creating an app at Reddit's app preferences page.

For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

   ~/Library/Application Support/Claude/claude_desktop_config.json

For Cursor, save this as mcp.json in your Cursor configuration directory at:

   ~/.cursor/mcp.json

3. Restart Claude Desktop / Cursor

Open Claude Desktop and you should now see Reddit as an available integration.

Or restart Cursor.

Available Tools

The server provides the following tools:

Read-only Tools (require only client credentials):

- get_user_info(username) - Get detailed user analysis with engagement insights
- get_top_posts(subreddit, time_filter, limit) - Get and analyze top posts
- get_subreddit_stats(subreddit) - Get comprehensive subreddit analysis
- get_trending_subreddits() - Get list of trending subreddits

Authenticated Tools (require user credentials):

- create_post(subreddit, title, content, flair, is_self) - Create an optimized post
- reply_to_post(post_id, content, subreddit) - Add a reply with engagement insights
- reply_to_comment(comment_id, content, subreddit) - Add a strategic reply

Example Queries

Here are some examples of what you can ask an AI assistant connected to this server:

- "Analyze u/spez's Reddit activity"
- "Show me the top posts from r/Python this week"
- "Get statistics about r/AskReddit"
- "What are the trending subreddits right now?"
- "Create a post in r/Python about a new project"
- "Reply to this post with an insightful comment"
- "What's the best time to post in this subreddit?"

Advanced Features

AI-Driven Analysis

The server provides intelligent analysis in several areas:

1. User Analysis

- Engagement patterns
- Activity trends
- Community influence
- Personalized recommendations

2. Post Analysis

- Performance metrics
- Engagement quality
- Timing optimization
- Content impact assessment

3. Community Analysis
- Health indicators
- Growth patterns
- Activity metrics
- Engagement opportunities

Smart Response Formatting

- Organized bullet points
- Engagement statistics
- AI-driven insights
- Strategic recommendations
- Performance metrics

Authentication

The server supports two levels of authentication:

1. Read-only Access

- Requires: client_id and client_secret
- Allows: Fetching public data, reading posts/comments

2. Authenticated Access
- Requires: All read-only credentials PLUS username and password
- Allows: All read-only operations PLUS posting and commenting

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

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

Claude Desktop / Cursor

McpServers

Reddit MCP Server

What is MCP?

Features

Installation

Available Tools

Read-only Tools (require only client credentials):

Authenticated Tools (require user credentials):

Example Queries

Advanced Features

AI-Driven Analysis

Smart Response Formatting

Authentication

Contributing

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀