Senso MCP — MCP Server for Joomla
Senso MCP turns a Joomla 5 or 6 site into a Model Context Protocol (MCP) server.
Connect Claude, ChatGPT or any MCP-compatible AI assistant and manage your Joomla site in natural language.
- Website:
- Documentation:
- Download (installable package, with automatic updates):
This repository contains the source code of the free pack.
What it does
The MCP server runs inside Joomla itself: no extra server, no Node.js bridge. Your AI assistant connects to
your site and acts through well-defined, permission-checked tools.
With the free pack, an assistant can:
- create, read, update, reorder and delete articles, categories and tags;
- list, compare and restore article versions;
- read site information (languages, template, versions) to ground its actions;
- fetch a rendered front-end page to check the result;
- clear the Joomla caches.
Security
- OAuth 2.1 authorization with standard discovery endpoints, or a Joomla API token.
- Every tool is gated by Joomla's own ACL: the assistant can only do what the connected account may do.
- Scoped, revocable access per client. Passwords are never exposed.
Requirements
- Joomla 5.x or 6.x (no compatibility plugin needed)
- PHP 8.2 or later
Installation
- Download the package from .
- Install it in Joomla: System → Install → Extensions.
- Connect your assistant: see Connect Claude
or Connect ChatGPT.
A step-by-step guide is available in the
Getting Started section of the documentation.
What is in this repository
| Folder | Extension |
|---|---|
packages/com_sensomcp |
Component: MCP server, OAuth, settings, dashboard |
packages/plg_webservices_sensomcp |
Web Services plugin: API routes |
packages/plg_system_sensomcp |
System plugin: discovery endpoints |
packages/plg_system_sensomcpchangelog |
System plugin: changelog display |
packages/plg_task_sensomcp |
Scheduled task plugin: maintenance |
packages/plg_sensomcp_site |
Tools: site information |
packages/plg_sensomcp_content |
Tools: articles, categories, tags, versions |
Going further
Additional plugins add tools for custom fields, media, menus, SEO, multilingual sites, modules, templates,
users, extensions and YOOtheme Pro. See .
Support
- Documentation and FAQ:
- Community chat:
- Bug reports: open an issue in this repository.
License
GNU General Public License version 2 or later. See LICENSE.
Developed by Sensomedia. The Joomla!® name is used under a limited licence from
Open Source Matters; Senso MCP is not affiliated with or endorsed by Open Source Matters or the Joomla!® project.
