WordPress Reader for Claude Desktop

Connect your WordPress.com account to Claude Desktop and access your WordPress Reader, notifications, and more directly from Claude.

✨ What This Does

This tool allows you to use Claude Desktop to:

📖 Read your WordPress feed - See posts from blogs you follow
🔔 Check notifications - View comments, likes, and follows
🏷️ Manage tags - Subscribe/unsubscribe from topics
👥 Manage follows - Follow/unfollow blogs
🏢 View A8C posts - Get Automattic company updates
⭐ Get recommendations - Discover new blogs

🚀 Quick Setup (5 minutes)

Step 1: Prerequisites

You need:

A WordPress.com account
Claude Desktop installed on your computer
Node.js installed (Download here)

Step 2: Get Your WordPress.com App Credentials

Go to WordPress.com Developer Apps
Click "Create New Application"
Fill in:
- Name: "Claude WordPress Reader" (or any name you like)
- Description: "Personal WordPress Reader for Claude Desktop"
- Website URL: http://localhost:3000
- Redirect URI: http://localhost:3000/auth/callback
Click "Create"
Copy your Client ID and Client Secret (you'll need these in Step 4)

Step 3: Run the Setup Script

Open Terminal (Mac/Linux) or Command Prompt (Windows) and run:

# Navigate to this folder
cd path/to/wordpress-reader-mcp

# Run the automated setup
npm run setup

The script will:

Install all dependencies
Set up your environment
Build the applications
Try to configure Claude Desktop automatically
Start the background authentication service

Step 4: Enter Your WordPress Credentials

When prompted, enter:

Your WordPress.com Client ID (from Step 2)
Your WordPress.com Client Secret (from Step 2)

Step 5: Authenticate with WordPress.com

The setup will:

Start the authentication server
Open your browser to authenticate with WordPress.com
Configure everything automatically

Step 6: Test in Claude Desktop

Restart Claude Desktop and try these commands:

"Show me my WordPress Reader feed"
"How many unread notifications do I have?"
"Get posts from the technology tag"

🔧 Manual Setup (If Automatic Setup Fails)

If the automatic setup doesn't work, follow these manual steps:

1. Install Dependencies

# Install web app dependencies
cd web-app
npm install

# Install MCP server dependencies
cd ../mcp-server  
npm install

# Go back to root
cd ..

2. Configure Environment

Create web-app/.env file:

WORDPRESS_CLIENT_ID=your_client_id_here
WORDPRESS_CLIENT_SECRET=your_client_secret_here
REDIRECT_URI=http://localhost:3000/callback
PORT=3000
JWT_SECRET=your_random_secret_here
MCP_SERVER_URL=http://localhost:3001

3. Build Applications

cd web-app && npm run build
cd ../mcp-server && npm run build
cd ..

4. Configure Claude Desktop

Find your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Add this to the mcpServers section:

{
  "mcpServers": {
    "wordpress-reader": {
      "command": "node",
      "args": ["FULL_PATH_TO_THIS_FOLDER/mcp-server/dist/index.js"],
    }
  }
}

Replace FULL_PATH_TO_THIS_FOLDER with the actual path to this folder.

5. Authenticate

# Start the authentication server
cd web-app && npm run dev

Open browser to http://localhost:3000/auth/test and complete WordPress.com login.

📖 Available Commands in Claude

Once set up, you can use these natural language commands in Claude Desktop:

Reader Feed

"Show me my WordPress Reader feed"
"Get the latest 10 posts from my feed"
"Show me posts from today"

Notifications

"Check my WordPress notifications"
"How many unread notifications do I have?"
"Show me only comment notifications"
"Mark my notifications as read"

Tags & Topics

"Show me posts tagged with 'technology'"
"Subscribe me to the 'design' tag"
"What tags am I following?"

Blog Management

"Show me blogs I'm following"
"Follow the blog example.com"
"Get blog recommendations for me"

Automattic Content

"Show me recent A8C posts"
"Get Automattic company updates"

🔍 Troubleshooting

"No tools available" or "Authentication required"

Check if the background service is running: npm run service:status
If not running, start it: npm run service:start
Complete authentication at http://localhost:3000/auth/test
Restart Claude Desktop

Background service issues

Check service status: npm run service:status
View service logs: npm run service:logs
Restart service: npm run service:restart
Check if port 3000 is available: lsof -i :3000 (Mac/Linux)

"Command not found: npm"

Install Node.js from nodejs.org

"Permission denied" errors

Try running with sudo on Mac/Linux or "Run as Administrator" on Windows

Authentication not working

Check your WordPress.com app credentials
Make sure redirect URI is exactly http://localhost:3000/auth/callback
Check that web-app is running on port 3000

Claude Desktop not recognizing tools

Check the config file path is correct
Make sure the path to index.js is absolute (full path)
Restart Claude Desktop completely

🛠️ Advanced Usage

Background Authentication Service

WordPress Reader runs a background authentication service that handles token management automatically. This service needs to run constantly for seamless authentication.

Service Management Commands:

# Check service status
npm run service:status

# Start service
npm run service:start

# Stop service
npm run service:stop

# Restart service
npm run service:restart

# View service logs
npm run service:logs

# Check service health
npm run service:health

Automatic Service Management:

The setup script automatically starts the service
The MCP server will try to start the service if it's not running
Service runs in the background and persists across reboots (with optional system integration)

Manual Service Management:

# Development mode (with auto-reload)
cd web-app && npm run dev

# Production mode (background service)
npm run service:start

System Integration (Optional): To start the service automatically on system boot:

# Install as system service
node service-manager.js install

# macOS: Enable with launchctl
# Linux: Enable with systemctl --user

Viewing Logs

MCP server logs are in: mcp-server/mcp-server.log

Environment Variables

You can set these in your shell:

DEBUG=true - Enable debug logging
NODE_ENV=development - Development mode

🔒 Security & Privacy

Your WordPress.com credentials are stored locally only
Authentication tokens are cached securely
No data is sent to third parties
All communication is encrypted (HTTPS/TLS)
Confidentiality Protection: Automatically checks for the p2_confidentiality_disabled sticker on WordPress.com blogs; only allows AI access to blogs with this sticker
- Set DISABLE_CONFIDENTIALITY_CHECK=true in the MCP server environment to disable this protection (not recommended)

📞 Support

If you need help:

Check the troubleshooting section above
Look for error messages in the terminal
Check the MCP server logs
Ensure your WordPress.com app is configured correctly

🎉 Enjoy!

You now have full WordPress.com integration in Claude Desktop. Explore your feeds, manage notifications, and discover new content all through natural conversation with Claude!