# wordpress-mcp-cli MCP server

> Enables AI agents to manage WordPress content, media, users, and SEO settings via the REST API and a specialized helper plugin.

- Repository: https://github.com/thenavidm/wordpress-mcp-cli
- Page: https://hostedmcp.org/servers/thenavidm/wordpress-mcp-cli
- Transport: stdio
- Stars: 0
- License: MIT

## Install

### Claude Code

```sh
claude mcp add wordpress-mcp-cli -- npx -y @thenavidm/wordpress-mcp-cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "wordpress-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@thenavidm/wordpress-mcp-cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "wordpress-mcp-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thenavidm/wordpress-mcp-cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"wordpress-mcp-cli","type":"stdio","command":"npx","args":["-y","@thenavidm/wordpress-mcp-cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "wordpress-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@thenavidm/wordpress-mcp-cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add wordpress-mcp-cli -- npx -y @thenavidm/wordpress-mcp-cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.wordpress-mcp-cli]
command = "npx"
args = ["-y", "@thenavidm/wordpress-mcp-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user wordpress-mcp-cli npx -- -y @thenavidm/wordpress-mcp-cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "wordpress-mcp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@thenavidm/wordpress-mcp-cli"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `WORDPRESS_APP_PASSWORD` | no | no |  |
| `WORDPRESS_DEFAULT_SITE` | no | no |  |
| `WORDPRESS_SITES` | no | no |  |
| `WORDPRESS_SITE_URL` | no | no |  |
| `WORDPRESS_USERNAME` | no | no |  |

## Tools (30)

- `wp_list_sites`
- `wp_get_me`
- `wp_get_settings`
- `wp_search`
- `wp_list_posts`
- `wp_get_post`
- `wp_create_post`
- `wp_update_post`
- `wp_delete_post`
- `wp_list_pages`
- `wp_create_page`
- `wp_update_page`
- `wp_list_post_types`
- `wp_list_custom`
- `wp_get_custom`
- `wp_create_custom`
- `wp_update_custom`
- `wp_delete_custom`
- `wp_list_media`
- `wp_get_media`
- `wp_upload_media`
- `wp_delete_media`
- `wp_list_categories`
- `wp_create_category`
- `wp_list_tags`
- `wp_create_tag`
- `wp_list_taxonomies`
- `wp_list_taxonomy_terms`
- `wp_list_users`
- `wp_list_comments`

## FAQ

### How do I authenticate with the WordPress MCP server?

You use a WordPress application password generated from your user profile screen. It is not your standard login password.

### Does this server require a plugin to work?

No plugin is required for basic functionality, but a helper plugin is needed to access Elementor layouts, Rank Math SEO, redirects, and bulk edits.

### Can the AI publish posts automatically?

Publishing requires deliberate confirmation because it is an irreversible action. The server defaults to creating drafts to ensure safety.

### What is the difference between the CLI and the MCP server?

The CLI is for terminal use, scripting, and cron jobs, while the MCP server is designed for integration with AI clients like Claude Desktop or Cursor.