reddirect
reddirect is a Reddit MCP server that lets you browse and interact with Reddit without API keys. Write operations require a one-time browser login.
Authentication
check_session– view current login status (anonymous or logged in)authorize– one-time browser login to enable write operations
Browse & Read
browse_subreddit– view posts sorted by hot, new, top, rising, or controversial (with time filters)get_post– fetch a full post with its comment tree (flat, depth-annotated)search_reddit– search globally or within a specific subredditget_subreddit_info– view description, rules, subscriber count, and NSFW statusget_flairs– retrieve available post flairs for a subredditget_user_profile– see karma breakdown and account age for any user
Write & Edit
create_post– submit text or link posts with optional flaircrosspost– crosspost an existing post to another subredditreply– reply to any post or commentedit_content– edit your own posts or commentsdelete_content– delete your own posts or comments
Engagement
vote– upvote, downvote, or remove a votesave_item/unsave_item– save or remove posts and commentsget_saved_items– retrieve your saved posts and comments
Account Management
get_inbox– view messages, mentions, and replies (filterable by type)mark_inbox_read– mark all unread messages as readget_subscriptions– list subscribed subredditssubscribe_subreddit/unsubscribe_subreddit– manage subreddit subscriptions
Queue
queue_action– enqueue write actions with randomized delaysqueue_status– check progress of queued actionsqueue_cancel– cancel a queued action
Allows browsing, posting, commenting, voting, and managing Reddit account without API keys.
Click on "Deploy 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., "@reddirect show me the top posts from r/programming"
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.
reddirect
Reddit MCP Server - No API Keys Required
Browse, post, comment, vote, and queue actions with timed delays from any MCP client. No API keys. Just install and go.
Why reddirect?
Every other Reddit MCP server requires you to register an app, get API keys, and configure OAuth. reddirect doesn't. It uses Reddit's public OAuth for reads and a one-time browser login for writes - zero setup friction.
Other Reddit MCPs | reddirect | |
API keys | Required | Not needed |
App registration | Required | Not needed |
OAuth setup | Required | Not needed |
Password stored | In config file | Never stored |
Install time | 10+ minutes | 30 seconds |
Related MCP server: reddit-rss-mcp
Quick Start
1. Install
npm install -g reddirect2. Add to your MCP client
Add to your MCP client configuration:
{
"mcpServers": {
"reddirect": {
"command": "npx",
"args": ["-y", "reddirect"]
}
}
}3. Use it
Reads work immediately - browse subreddits, search posts, check profiles.
For writes, run the authorize tool once. A Chrome window opens, you log into Reddit, and it closes automatically. That's it.
Tools
Tool | Description |
| Check auth status - anonymous or logged in |
| One-time browser login for write access |
Tool | Description |
| Browse posts with sort (hot / new / top / rising / controversial) and time filters |
| Fetch a post with flat, depth-annotated comment tree |
| Search globally or within a subreddit |
| Get description, rules, subscriber count |
| Get available post flairs for a subreddit (IDs and text) |
| Get karma breakdown and account age |
Tool | Description |
| Create text or link posts with optional flair (supports flair ID and text) |
| Share an existing post to a different subreddit (auto-fetches original title) |
| Reply to a post or comment |
| Edit your own posts or comments |
| Delete your own posts or comments |
Tool | Description |
| Upvote, downvote, or remove vote |
| Save a post or comment |
| Remove from saved items |
| List your saved items |
Tool | Description |
| View messages, mentions, and replies |
| Mark all unread as read |
| List subscribed subreddits |
| Subscribe to a subreddit |
| Unsubscribe from a subreddit |
Tool | Description |
| Enqueue any write operation with a randomized delay (default 2-3 min) |
| Check progress of queued items - pending, processing, completed, or failed |
| Cancel a specific queued item or clear the entire queue |
Space out multiple write operations with natural, randomized timing. Enqueue posts, replies, votes, or any write action - they execute sequentially with configurable delays between each.
How It Works
┌─────────────────────────────────────────────┐
│ MCP Client │
│ (Any MCP Client) │
└──────────────────┬──────────────────────────┘
│ stdio
┌──────────────────▼──────────────────────────┐
│ reddirect │
│ │
│ Reads ──► Anonymous OAuth ──► reddit API │
│ Writes ─► User token (JWT) ──► reddit API │
└─────────────────────────────────────────────┘Reads use Reddit's public installed_client OAuth grant - no credentials needed.
Writes use a token_v2 JWT extracted from a one-time Chrome login via the DevTools Protocol. No passwords are stored. The token lasts ~24 hours.
Requirements
Node.js 18+
Google Chrome - only needed once for the
authorizestep (not needed for reads)
Troubleshooting
Problem | Fix |
Writes say "authentication required" | Run the |
Chrome window doesn't appear | Make sure Google Chrome is installed |
"Server error" during login | Reddit rate limit - wait 10 minutes |
Session expired | Run |
Want to reset session | Delete |
License
MIT - License
Available Tools
20 toolsauthorizeAuthorize Reddit AccountA
One-time authorization: opens Reddit in your browser to connect your account. You click 'Allow', and reddirect gets permanent access. No API keys or passwords stored. Only needs to be done once.
Inputs: no named parameters.
browse_subredditBrowse SubredditA
Browse posts from a subreddit with sort options (hot, new, top, rising, controversial). For top and controversial, you can specify a time range.
Inputs: subreddit (required), sort, time, limit.
check_sessionCheck Reddit SessionA
Check if connected to a Reddit account. Shows username if authorized, or anonymous if not. Run 'authorize' tool to connect your account for write operations.
Inputs: no named parameters.
create_postCreate Reddit PostA
Create a new text or link post in a subreddit. Returns the permalink of the created post.
Inputs: subreddit (required), title (required), type, body, +1 more.
delete_contentDelete Post or CommentA
Delete your own Reddit post or comment.
Inputs: url (required).
edit_contentEdit Post or CommentA
Edit your own Reddit post or comment. Provide the URL of the content to edit.
Inputs: url (required), new_body (required).
get_inboxGet InboxA
Get your Reddit inbox messages including unread, mentions, and comment replies.
Inputs: filter, limit.
get_postGet Reddit PostA
Fetch a Reddit post and its comments. Returns comments as a flat array with depth and parent_id fields.
Inputs: url (required), comment_limit.
get_saved_itemsGet Saved ItemsB
Get your saved Reddit posts and comments.
Inputs: limit.
get_subreddit_infoGet Subreddit InfoB
Get subreddit information including description, rules, subscriber count, and whether it is NSFW.
Inputs: subreddit (required).
get_subscriptionsGet SubscriptionsA
List your subscribed subreddits.
Inputs: no named parameters.
get_user_profileGet User ProfileA
Get a Reddit user's public profile including karma breakdown and account age.
Inputs: username (required).
mark_inbox_readMark Inbox ReadB
Mark all unread inbox messages as read.
Inputs: no named parameters.
replyReply to Post or CommentC
Reply to a Reddit post or comment. Provide a full URL.
Inputs: url (required), body (required).
save_itemSave Post or CommentB
Save a Reddit post or comment to your saved items list.
Inputs: url (required).
search_redditSearch RedditB
Search Reddit globally or within a specific subreddit. Returns matching posts.
Inputs: query (required), subreddit, sort, time, +1 more.
subscribe_subredditSubscribe to SubredditB
Subscribe to a subreddit.
Inputs: subreddit (required).
unsave_itemUnsave Post or CommentB
Remove a Reddit post or comment from your saved items list.
Inputs: url (required).
unsubscribe_subredditUnsubscribe from SubredditB
Unsubscribe from a subreddit.
Inputs: subreddit (required).
voteVote on Post or CommentB
Upvote, downvote, or remove your vote on a single Reddit post or comment. One vote per call.
Inputs: url (required), direction (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct action or resource (e.g., authorize, browse, create, delete, vote, save). No two tools have overlapping purposes; even similar operations like subscribe/unsubscribe are clearly differentiated.
All tool names follow a consistent verb_noun pattern in lowercase snake_case (e.g., browse_subreddit, create_post, get_inbox). Even single-word names like 'authorize' and 'reply' fit the verb-first pattern.
With 20 tools, the server covers a wide range of Reddit operations without being bloated. The count is appropriate for a full-featured Reddit client, balancing usability and coverage.
The server covers core CRUD operations, voting, saving, searching, and inbox management. Missing a tool to list the user's own posts or comments, but this is a minor gap given the overall breadth.
Related MCP Connectors
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Reddit MCP — public Reddit data via the Atom/RSS feeds.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Free, no-key Bible MCP server — 86 translations in 32 languages, from any MCP client.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.827 PyPI3-
- AlicenseAqualityDmaintenanceA dependency-free MCP server that reads Reddit through its RSS feeds, enabling search, browsing subreddits, and reading post comments without any API keys or authentication.3157 npm18MIT
- AlicenseAqualityCmaintenanceAn MCP server that enables authenticated Reddit account actions like posting, commenting, voting, and messaging via the Reddit API.1232 npmMIT
- AlicenseNot gradedqualityBmaintenanceA local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.-