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

1. Go to WordPress.com Developer Apps

2. Click "Create New Application"

3. Fill in:

4. Click "Create"

5. 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:

1. Start the authentication server

2. Open your browser to authenticate with WordPress.com

3. 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"

1. Check if the background service is running: `npm run service:status`

2. If not running, start it: `npm run service:start`

3. Complete authentication at `http://localhost:3000/auth/test`

4. Restart Claude Desktop

Background service issues

1. Check service status: `npm run service:status`

2. View service logs: `npm run service:logs`

3. Restart service: `npm run service:restart`

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

1. Check your WordPress.com app credentials

2. Make sure redirect URI is exactly `http://localhost:3000/auth/callback`

3. Check that web-app is running on port 3000

Claude Desktop not recognizing tools

1. Check the config file path is correct

2. Make sure the path to `index.js` is absolute (full path)

3. 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:

1. Check the troubleshooting section above

2. Look for error messages in the terminal

3. Check the MCP server logs

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