Joomla MCP
@nasoma
About Joomla MCP
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.
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>"
}
}
}
}Tools
No tools detected
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
FAQ from Joomla MCP
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.
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.
What tools does Joomla MCP provide?
Six tools: get_joomla_articles(), get_joomla_categories(), create_article(), manage_article_state(), delete_article(), and update_article().
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.
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.
Frequently asked questions
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.
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.
What tools does Joomla MCP provide?
Six tools: `get_joomla_articles()`, `get_joomla_categories()`, `create_article()`, `manage_article_state()`, `delete_article()`, and `update_article()`.
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`.
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.
Basic information
More Other MCP servers
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
EverArt
modelcontextprotocolModel Context Protocol Servers
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Comments