Model Context Protocol server for TYPO3 v14: workspace-safe, TCA-driven tools for pages, records, schemas, files and the editorial workflow, served to LLM clients over HTTP (OAuth 2.1 + PKCE) or stdio and mirrored 1:1 onto the TYPO3 CLI. Maintained fork of hauptsacheNet/typo3-mcp-server by Marco Pfeiffer.
- Editor-first tools —
GetPageTree,ReadTable,WriteTable,Search,AttachImage,ImportFromUrl,PublishWorkspace, … derived from TCA, so third-party tables work without adapters. - Workspace transparency — production writes are staged in a TYPO3 draft and clients only ever see stable live UIDs; trusted local mode (DDEV / Development context) edits live by design.
- Capability manifest — every tool declares its subsystems in
Configuration/Capabilities.yaml; removing a subsystem disables the tools that need it, outbound HTTP defaults toself. - Files, sandboxed — uploads (base64, URL, pre-signed
PUT) land infileadmin/mcp/, are create-only and deduplicated. - Dual-era protocol — MCP
2025-11-25sessions and stateless2026-07-28requests from one endpoint; the Abilities registry is projected into the same catalog asability_*tools.
| Component | Version |
|---|---|
| TYPO3 | ^14.3 (cms-core, cms-backend, cms-workspaces) |
| PHP | ^8.4 (tested on 8.4 and 8.5) |
| MCP SDK | logiscape/mcp-sdk-php ^2.0 |
| Abilities | webconsulting/typo3-abilities ^1.2 (VCS repository, see below) |
composer config repositories.typo3-abilities vcs https://github.com/dirnbauer/typo3-abilities
composer require hn/typo3-mcp-server
vendor/bin/typo3 extension:setupDistribution is Composer/Git only — there is no TER release.
Open User → MCP Server in the backend: the endpoint URL with setup steps
for Claude, Cursor and Codex, your access tokens, a server-side connection
check and the list of tools a client is offered (English and German, light and
dark mode). Extension settings
(fileSandboxRoot, maxFileSizeMb, localUnsafeMode, allowedOrigins,
enforceCapabilityManifest, sessionTimeout, …) are documented in
Configuration; hardening means deleting
lines from Configuration/Capabilities.yaml.
vendor/bin/typo3 mcp:server # local stdio for Cursor
vendor/bin/typo3 mcp:oauth create <backend-user> --ttl-days 30 # static bearer token
vendor/bin/typo3 mcp:tool:list # every tool, also as mcp:<name>
vendor/bin/typo3 mcp:read-table --table tt_content --pid 1 --jsonRemote clients connect to https://your-site/mcp and authenticate through the
OAuth flow with their existing backend login. See
Usage for an example session and the tool
families, and the tool reference for parameters.
composer install # installs a throw-away TYPO3 (SQLite) for the tests
composer test # unit + functional
composer phpstan # level 8, no baseline
composer php-cs-fixer:fix # TYPO3 coding standards
composer test:protocol # stable + stateless stdio smoke matrixPHP 8.4+ is required locally; a DDEV project is included. Contributor notes, repository layout and the upstream-sync workflow are in Development.
The manual lives in Documentation/:
Introduction ·
Installation ·
Usage ·
Configuration ·
Tools ·
Testing ·
Architecture ·
Abilities integration ·
Troubleshooting ·
Changelog.
Thanks to hauptsacheNet for the original, to in2code (in2mcp) for the rate-limiting and identity-summary ideas, and to balatD for the developer-introspection inspiration.
GPL-2.0-or-later