Provides tools for accessing Reddit data including fetching hot/new/top posts from subreddits, retrieving post content with comment trees, searching posts, and getting user profiles and activity information through Reddit's API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Reddit MCP Servershow me the top posts from r/technology this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reddit MCP Server
MCP server for Reddit API - Access Reddit data through a unified API interface with TOON format for 90%+ token savings.
Features
Fetch hot/new/top posts from any subreddit
Get detailed post content including comment trees
Search Reddit posts by query
Get user profile information and activity
Get subreddit information
Returns data in TOON format for token efficiency
Proxy support for enterprise environments
Installation
npm install @yilin-jing/reddit-mcpOr run directly:
npx @yilin-jing/reddit-mcpConfiguration
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["-y", "@yilin-jing/reddit-mcp"],
"env": {}
}
}
}Environment Variables (Optional)
PROXY_URL- HTTP/HTTPS proxy URLHTTP_PROXY- Alternative proxy settingHTTPS_PROXY- Alternative proxy setting
Available Tools
Tool | Description |
| Get hot posts from a subreddit |
| Get new posts from a subreddit |
| Get top posts from a subreddit (with time filter) |
| Get post details with comments tree |
| Search Reddit posts by query |
| Get Reddit user profile information |
| Get posts submitted by a user |
| Get comments made by a user |
| Get subreddit information |
Usage Examples
Get Hot Posts from a Subreddit
Tool: get_subreddit_hot
Args: { "subreddit": "programming", "limit": 10 }Get Top Posts of the Week
Tool: get_subreddit_top
Args: { "subreddit": "askreddit", "time": "week", "limit": 20 }Get Post Content with Comments
Tool: get_post_content
Args: { "post_id": "abc123", "comment_limit": 30, "comment_depth": 5 }Search Posts
Tool: search_posts
Args: { "query": "typescript tutorial", "subreddit": "programming", "sort": "top", "time": "month" }Get User Information
Tool: get_user_info
Args: { "username": "spez" }Output Format
All responses are returned in TOON format for maximum token efficiency. Example cleaned post data:
id:"abc123"
title:"Example Post Title"
subreddit:"programming"
author:"username"
score:1234
upvoteRatio:0.95
comments:56
created:"2024-01-15T10:30:00.000Z"
url:"https://example.com"
permalink:"https://reddit.com/r/programming/comments/abc123/example_post/"Development
# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run dev
# Run tests
npm testLicense
MIT