dev
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 3s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 17s
Generic: Repo Health / Scripts governance (push) Has been cancelled
Generic: Repo Health / Repository health (push) Has been cancelled
Generic: Repo Health / Report Issues (push) Has been cancelled
joomla-api-mcp
MCP server for Joomla Web Services API operations
Model Context Protocol server for the Joomla Web Services API -- full CRUD for articles, categories, users, menus, contacts, tags, media, plugins, and more.
| Type | MCP Server |
| Language | Node.js |
| Tools | 67 tools across 15 resource groups |
| License | GPL-3.0-or-later |
| Platform | Gitea (primary) |
Overview
joomla-api-mcp wraps the entire Joomla Web Services REST API into MCP tools that Claude Code can call directly. It supports multi-site connections via named connection configs.
Resource Coverage
| Group | Operations |
|---|---|
| Articles | list, get, create, update, delete |
| Categories | list, create, update, delete |
| Users | list, get, create, update, delete, groups |
| Contacts | list, get, create, update, delete |
| Menus | list types, list/get/create/update/delete items |
| Tags | list, get, create, update, delete |
| Custom Fields | list, get, create, delete |
| Plugins | list, update (enable/disable) |
| Modules | list |
| Templates | list |
| Media | list, get file, delete file, create folder |
| Banners | list, get, create, delete, list clients |
| Newsfeeds | list, get, create, delete |
| Messages | list, get, send, delete |
| Redirects | list, create, delete |
| Config | get, update |
| Content History | list versions |
| Checkin | unlock checked-out items |
| Associations | list multilingual associations |
| Generic | raw API request, list connections |
Wiki Pages
Guides
- Installation -- setup, .env configuration, Claude Code registration, multi-site connections
Reference
- API -- all 67 tools with parameters, grouped by resource type
- Architecture -- source file map, component design, connection handling
Templates
- Templates Index -- workflow and config templates
- README Template -- README template for MCP repos
Related Wikis
| Repo | Purpose |
|---|---|
| backup-mcp | Backup MCP (uses Joomla API for Akeeba) |
| MokoWaaS | Joomla WaaS system plugin |
| Template-Client-WaaS | Client site template |
| MokoOnyx | Joomla admin template |
MokoStandards -- central standards hub for all Moko Consulting projects.
Documentation
Full documentation is available on the Wiki.
Contributing
See the wiki for development guidelines and contribution instructions.
License
This project is licensed under the GNU General Public License v3.0 or later -- see the LICENSE file.
Releases
2
v1.0.0 — Stable Release
Latest
Languages
Markdown
42.3%
TypeScript
37.3%
Makefile
9.9%
Shell
6%
JavaScript
2.6%
Other
1.9%