How do I install the joomla mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

It reads `JOOMLA_BASE_URL`, `BEARER_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Joomla MCP Server

1. Access User Profile: Log in to the Joomla Administrator interface and navigate to the Users menu, then select Manage.

Local serverstdioPython

What is the Joomla MCP Server?

Access User Profile: Log in to the Joomla Administrator interface and navigate to the Users menu, then select Manage.

The short version

The Joomla MCP (Model Context Protocol) Server enables AI assistants, such as Claude, to interact with Joomla websites via the Joomla Web Services API. It provides tools to manage articles using an AI assistant.

Retrieve all articles from a Joomla website
List all content categories
Create new articles
Manage article states (published, unpublished, trashed, or archived)
Delete articles
Update articles (requires both introtext and fulltext, with a "Read more" break)

What it needs from you

Python 3.11+ - Joomla 4.x or 5.x with the Web Services API plugin enabled - API Bearer token for authentication

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
Area	Tools
Articles	get_joomla_articles, get_joomla_article, create_article, update_article, manage_article_state, move_article_to_trash
Categories	get_joomla_categories, get_joomla_category, create_category, update_category, delete_category
Tags	get_joomla_tags, get_joomla_tag, create_tag, update_tag, delete_tag; article tag assignment through update_article(tags=[IDs])
Fields	get_joomla_fields, get_joomla_field, create_field, update_field, delete_field, get_joomla_field_groups, get_joomla_field_group, create_field_group, update_field
Media	get_joomla_media, get_joomla_media_file, upload_media, update_article_images

How to install the Joomla MCP Server

{
  "mcpServers": {
    "Joomla Articles MCP": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}",
        "run",
        "--locked",
        "--env-file",
        "{{PATH_TO_PROJECT}}/.env",
        "joomla-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Python 3.11+ - Joomla 4.x or 5.x with the Web Services API plugin enabled - API Bearer token for authentication

Frequently asked questions

1. Access User Profile: Log in to the Joomla Administrator interface and navigate to the Users menu, then select Manage. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.