WordPress Reader for Claude Desktop

Manual Setup If Automatic Setup Fails

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

# Install web app dependencies cd web-app npm install # Install MCP server dependencies cd ../mcp-server npm install # Go back to root cd ..

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

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

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

{ "mcpServers": { "wordpress-reader": { "command": "node", "args": ](https://developer.wordpress.com/apps/)["FULL_PATH_TO_THIS_FOLDER/mcp-server/dist/index.js"], } } }

ReplaceFULL_PATH_TO_THIS_FOLDERwith the actual path to this folder.

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

Open browser tohttp://localhost:3000/auth/testand complete WordPress.com login.

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

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

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

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

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

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 athttp://localhost:3000/auth/test
- Restart Claude Desktop
- 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)

Try running withsudoon Mac/Linux or "Run as Administrator" on Windows
- Check your WordPress.com app credentials
- Make sure redirect URI is exactlyhttp://localhost:3000/auth/callback
- Check that web-app is running on port 3000
- Check the config file path is correct
- Make sure the path toindex.jsis absolute (full path)
- Restart Claude Desktop completely

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

# 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

- 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)

# 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

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

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

- 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 thep2_confidentiality_disabledsticker on WordPress.com blogs; only allows AI access to blogs with this sticker

- SetDISABLE_CONFIDENTIALITY_CHECK=truein the MCP server environment to disable this protection (not recommended)
- 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

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!

An MCP server for WordPress plugin audits

A free WordPress plugin that turns your site into a governed MCP server: 153 abilities that are all off until you switch them on, bound to a least-privilege WordPress user, with every call audited.

Works the tickets of the self hosted Simple Support System helpdesk for Concrete CMS: read a ticket with its comments, reply, change its state, manage attachments.

Connects Claude to WordPress sites to create posts and manage sites using the WordPress REST API.

A personality-based MCP server for WordPress, providing role-appropriate tools for content management.

Lightweight WordPress MCP server with 42 tools. Token-optimized responses reduce REST API verbosity by 95%+. Posts, pages, users, plugins, themes, media, taxonomies, comments.

Manage WordPress sites and create content with AI-generated featured images.

Manage WordPress sites via the REST API. Enables AI assistants to handle content, posts, and site configurations.

A secure bridge between AI assistants and WordPress, enabling site management and content operations through natural language.

The most secure MCP Server for WordPress with built-in Undo