MCP.so
Sign In

Joomla MCP Server

@nasoma

Basic information

Category

Other

License

MIT

Transports

stdio

Author

nasoma

Submitted by

Ana Guy

About Joomla MCP Server

The Joomla MCP Server facilitates interaction between AI assistants (like Claude) and Joomla websites through the Joomla Web Services API. It provides tools to manage articles, including retrieving, creating, updating, and deleting content, as well as managing article states.

Joomla MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Joomla Articles MCP": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}",
        "run",
        "main.py"
      ],
      "env": {
        "JOOMLA_BASE_URL": "<your_joomla_website_url>",
        "BEARER_TOKEN": "<your_joomla_api_token>"
      }
    }
  }
}

Joomla MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Joomla MCP?

Joomla MCP is a Model Context Protocol server that lets AI assistants like Claude interact with Joomla websites via the Joomla Web Services API, primarily to manage articles.

How to use Joomla MCP?

Install Python 3.11+, clone the repository, set up a virtual environment with uv, and configure the server in your AI assistant (e.g., Claude Desktop) by providing the Joomla base URL and a bearer token in environment variables.

Key features of Joomla MCP

  • Retrieve all articles from a Joomla website
  • List all content categories
  • Create new articles with optional plain-text-to-HTML conversion
  • Manage article states (published, unpublished, trashed, archived)
  • Delete articles
  • Update articles (requires both introtext and fulltext with a "Read more" break)

Use cases of Joomla MCP

  • Manage Joomla articles through conversational AI commands
  • Automate content creation and publishing workflows
  • Bulk update or delete articles without manual intervention
  • Integrate Joomla content management with AI-powered assistants

Frequently asked questions

1

What are the requirements for using Joomla MCP?

Python 3.11+, a Joomla 4.x or 5.x site with the Web Services API plugin enabled, and a valid API bearer token.

2

How do I obtain a Joomla API token?

Log in to the Joomla Administrator, go to Users > Manage, edit the Super User account, open the "Joomla API Token" tab, click Generate, and copy the token.

3

What tools does Joomla MCP provide?

Six tools: `get_joomla_articles()`, `get_joomla_categories()`, `create_article()`, `manage_article_state()`, `delete_article()`, and `update_article()`.

4

How do I configure Joomla MCP for Claude Desktop?

Add an entry to `claude_desktop_config.json` with the path to `uv`, the project directory, and the environment variables `JOOMLA_BASE_URL` and `BEARER_TOKEN`.

5

Are there security considerations?

Treat the API token like a password, as it provides site access. The server sanitizes HTML to prevent XSS, and HTTPS should be used for API communications.

Comments

More Other MCP servers