PHPackages                             hn/typo3-mcp-server - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. hn/typo3-mcp-server

ActiveTypo3-cms-extension[API Development](/categories/api)

hn/typo3-mcp-server
===================

TYPO3 extension that provides a Model Context Protocol (MCP) server for interacting with TYPO3 pages and records

v0.4.4(1w ago)8523.4k↓21.7%21[7 issues](https://github.com/hauptsacheNet/typo3-mcp-server/issues)[9 PRs](https://github.com/hauptsacheNet/typo3-mcp-server/pulls)1GPL-2.0-or-laterPHPPHP &gt;=8.2CI passing

Since Jul 27Pushed 5d ago12 watchersCompare

[ Source](https://github.com/hauptsacheNet/typo3-mcp-server)[ Packagist](https://packagist.org/packages/hn/typo3-mcp-server)[ Docs](https://github.com/hauptsacheNet/typo3-mcp-server)[ RSS](/packages/hn-typo3-mcp-server/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (10)Dependencies (34)Versions (91)Used By (1)

TYPO3 MCP Server Extension
==========================

[](#typo3-mcp-server-extension)

This extension provides a Model Context Protocol (MCP) server implementation for TYPO3 that allows AI assistants to safely view and manipulate TYPO3 pages and records through TYPO3's workspace system.

🔒 Safe AI Content Management with Workspaces
--------------------------------------------

[](#-safe-ai-content-management-with-workspaces)

**All content changes are automatically queued in TYPO3 workspaces**, making it completely safe for AI assistants to create, update, and modify content without immediately affecting your live website. Changes require explicit publishing to become visible to site visitors.

🧪 Continuously Tested With Real LLMs
------------------------------------

[](#-continuously-tested-with-real-llms)

Every push to `main` runs a benchmark that has the latest models from **Anthropic, OpenAI, Mistral, and Google** actually use this MCP to perform real TYPO3 tasks. That's how we stay vendor-independent and prove the tool descriptions convey what they claim across very different prompting styles — your AI assistant of choice should just work, not only ours. Click any badge for the full run-by-run history.

[![haiku-4.5](https://camo.githubusercontent.com/287101d4509d2475b7c21d692889c2a5fc4e4d50830d4f3266385addcc09a387/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f75726c3d68747470732533412532462532467363726970742e676f6f676c652e636f6d2532466d6163726f7325324673253246414b66796362777953344e6176504d44515762515159436833754b41347a4a3543387378676778545a51515064676a584f5a3756743442705564356d7a576473574d716a7a6e6949253246657865632671756572793d2532342e70657263656e74616765732535422532326861696b752d342e35253232253544267375666669783d253235266c6162656c3d6861696b752d342e35)![gpt-5.4-mini](https://camo.githubusercontent.com/6903abb0a944759fb7074d7191ba8d824b1ff037a6298e8f163b3cd8edf9827f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f75726c3d68747470732533412532462532467363726970742e676f6f676c652e636f6d2532466d6163726f7325324673253246414b66796362777953344e6176504d44515762515159436833754b41347a4a3543387378676778545a51515064676a584f5a3756743442705564356d7a576473574d716a7a6e6949253246657865632671756572793d2532342e70657263656e74616765732535422532326770742d352e342d6d696e69253232253544267375666669783d253235266c6162656c3d6770742d352e342d6d696e69)![gpt-oss-120b](https://camo.githubusercontent.com/f1c239064750c54792e600e97b75672340a1d1b0f06ee833915f9f4c1bf38cb5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f75726c3d68747470732533412532462532467363726970742e676f6f676c652e636f6d2532466d6163726f7325324673253246414b66796362777953344e6176504d44515762515159436833754b41347a4a3543387378676778545a51515064676a584f5a3756743442705564356d7a576473574d716a7a6e6949253246657865632671756572793d2532342e70657263656e74616765732535422532326770742d6f73732d31323062253232253544267375666669783d253235266c6162656c3d6770742d6f73732d31323062)![mistral-large-2512](https://camo.githubusercontent.com/4e5ffcc5337adb02b20874704ec4669d538f6ac856a492d78e1da293194fa6e4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f75726c3d68747470732533412532462532467363726970742e676f6f676c652e636f6d2532466d6163726f7325324673253246414b66796362777953344e6176504d44515762515159436833754b41347a4a3543387378676778545a51515064676a584f5a3756743442705564356d7a576473574d716a7a6e6949253246657865632671756572793d2532342e70657263656e74616765732535422532326d69737472616c2d6c617267652d32353132253232253544267375666669783d253235266c6162656c3d6d69737472616c2d6c617267652d32353132)![gemini-3-flash](https://camo.githubusercontent.com/ad348b9272406fb5a69af9fc64cdb4951edf05b9cfa0b4520c745eafe07336c8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64796e616d69632f6a736f6e3f75726c3d68747470732533412532462532467363726970742e676f6f676c652e636f6d2532466d6163726f7325324673253246414b66796362777953344e6176504d44515762515159436833754b41347a4a3543387378676778545a51515064676a584f5a3756743442705564356d7a576473574d716a7a6e6949253246657865632671756572793d2532342e70657263656e746167657325354225323267656d696e692d332d666c617368253232253544267375666669783d253235266c6162656c3d67656d696e692d332d666c617368)](https://docs.google.com/spreadsheets/d/18jL34ymMaUfoCtL32FauPu3n0cTbBTLKuVO7dmGSAS4/edit?usp=sharing)

What Can You Do?
----------------

[](#what-can-you-do)

With the TYPO3 MCP Server, your AI assistant can help you:

### 📝 **Content Management**

[](#-content-management)

- **Translate Pages**: "Translate the /about-us page to German" - The AI reads your content, translates it, and creates proper language versions
- **Import Documents**: "Create a news article from this Word document" - Transform external documents into TYPO3 content with proper structure
- **Bulk Updates**: "Update all product descriptions to include our new sustainability message" - Make consistent changes across multiple pages

### 🔍 **Content Analysis &amp; SEO**

[](#-content-analysis--seo)

- **SEO Optimization**: "Add meta descriptions to all pages that don't have them" - Automatically generate missing SEO content based on page content
- **Tone Analysis**: "Review the tone of our product pages and make them more friendly" - Get suggestions for improving content voice and style
- **Content Audit**: "Find all pages mentioning our old company name" - Quickly locate content that needs updating

### 🚀 **Productivity Boosters**

[](#-productivity-boosters)

- **Template Application**: "Apply our standard legal disclaimer to all service pages" - Consistently apply content patterns
- **Content Migration**: "Copy all news articles from 2023 to the archive folder" - Reorganize content efficiently
- **Multi-language Management**: "Ensure all German pages have English translations" - Identify and fill translation gaps

All these operations happen safely in workspaces, giving you full control to review before publishing!

> 💡 **Want to know how it works?** Check out our [Technical Overview](TECHNICAL_OVERVIEW.md) for detailed information about the implementation, available tools, and real-world examples with actual tool calls.

Project Status
--------------

[](#project-status)

FeatureStatusNotes**MCP Connection**✅ ReadyHTTP and stdin/stdout protocols (thanks to [logiscape/mcp-sdk-php](https://github.com/logiscape/mcp-sdk-php))**Authentication**✅ ReadyOAuth for Backend Users**Page Tree Navigation**✅ ReadyPage tree view similar to the TYPO3 backend**Page Content Discovery**✅ ReadySimilar to the List or Page module with backend layout support**Record Reading/Writing**✅ ReadyRead and write any workspace-capable TYPO3 table (core &amp; extensions) with full schema inspection**Content Translation**⚠️ ExperimentalImplemented, needs real-world testing**Fileadmin Support**❌ MissingNot yet implemented**Workspace Selection**❌ MissingCurrently uses the first writable workspace of the userWhile there are a lot of automated tests, TYPO3 instances are widely different and Language Models are also widely different. Feel free to [create issues here on GitHub](https://github.com/logiscape/mcp-sdk-php/issues) or [share experiences in the typo3-core-ai channel](https://typo3.slack.com/archives/C091M0M7BL6).

Installation
------------

[](#installation)

```
composer require hn/typo3-mcp-server
```

**Requirements:**

- TYPO3 v13.4+
- TYPO3 Workspaces extension (automatically installed as dependency)

Usage
-----

[](#usage)

### Quick Start

[](#quick-start)

There are two ways to connect AI assistants like Claude Desktop to your TYPO3 installation:

#### Option 1: OAuth Authentication (Recommended)

[](#option-1-oauth-authentication-recommended)

For secure remote access with proper authentication:

1. Go to **\[Username\] → MCP Server** in your TYPO3 backend
2. Copy the Server URL (and optionally the Integration Name)
3. Add the Integration to whatever MCP Client you are using.

[![MCP Server Setup](mcp_setup.png)](mcp_setup.png)

#### Option 2: Local Command Line Connection

[](#option-2-local-command-line-connection)

This method gives you admin privileges by default. Add this to your mcp config file of Claude Desktop or whatever client you are using.

```
{
   "mcpServers": {
      "[your-typo3-name]": {
         "command": "php",
         "args": [
            "vendor/bin/typo3",
            "mcp:server"
         ]
      }
   }
}
```

Development
-----------

[](#development)

### Running Tests

[](#running-tests)

```
# Functional tests (PHPUnit)
composer test

# E2E tests — spins up MySQL, TYPO3, and Playwright in Docker
Build/runTests.sh -s e2e

# E2E without Docker (host PHP + SQLite + local Playwright).
# Auto-selected when Docker is unavailable.
Build/runTests.sh -s e2e --no-docker

# E2E against an existing TYPO3 instance
TYPO3_BASE_URL=https://my.ddev.site Build/runTests.sh -s e2e

# See all options
Build/runTests.sh -h
```

### Adding New Tools

[](#adding-new-tools)

Tools are defined in the `Classes/MCP/Tools` directory. Each tool follows the MCP tool specification and maps to specific TYPO3 functionality.

Learn More
----------

[](#learn-more)

- 📖 **[Technical Overview](TECHNICAL_OVERVIEW.md)** - Comprehensive guide covering architecture, implementation details, and advanced usage
- 🏗️ **[Architecture Documentation](Documentation/Architecture/)** - Deep dives into specific implementation aspects:
    - [Workspace Transparency](Documentation/Architecture/WorkspaceTransparency.md) - How workspace complexity is hidden from AI
    - [Language Overlays](Documentation/Architecture/LanguageOverlays.md) - Multi-language content handling
    - [Inline Relations](Documentation/Architecture/InlineRelations.md) - Managing TYPO3's complex relation types

License
-------

[](#license)

GPL-2.0-or-later

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance97

Actively maintained with recent releases

Popularity45

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~21 days

Recently: every ~12 days

Total

16

Last Release

12d ago

PHP version history (2 changes)v0.1.0PHP &gt;=8.1.0

v0.2.2PHP &gt;=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/f18b6c8ad90bb53f9c5273b79360259b0ec172951de367046ac13ab0f1b44f63?d=identicon)[Nemo641](/maintainers/Nemo641)

---

Top Contributors

[![Nemo64](https://avatars.githubusercontent.com/u/1749936?v=4)](https://github.com/Nemo64 "Nemo64 (131 commits)")[![contemas-tschmidt](https://avatars.githubusercontent.com/u/14309291?v=4)](https://github.com/contemas-tschmidt "contemas-tschmidt (5 commits)")[![BugHunter2k](https://avatars.githubusercontent.com/u/5654631?v=4)](https://github.com/BugHunter2k "BugHunter2k (5 commits)")[![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (2 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (2 commits)")[![Tuurlijk](https://avatars.githubusercontent.com/u/790979?v=4)](https://github.com/Tuurlijk "Tuurlijk (1 commits)")[![ischmittis](https://avatars.githubusercontent.com/u/904789?v=4)](https://github.com/ischmittis "ischmittis (1 commits)")[![konradmichalik](https://avatars.githubusercontent.com/u/4558190?v=4)](https://github.com/konradmichalik "konradmichalik (1 commits)")

---

Tags

mcpmcp-servertypo3typo3-extension

### Embed Badge

![Health badge](/badges/hn-typo3-mcp-server/health.svg)

```
[![Health](https://phpackages.com/badges/hn-typo3-mcp-server/health.svg)](https://phpackages.com/packages/hn-typo3-mcp-server)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

611.1M8](/packages/netresearch-rte-ckeditor-image)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)[typo3/cms-redirects

TYPO3 CMS Redirects - Create manual redirects, list existing redirects and automatically createredirects on slug changes.

167.4M80](/packages/typo3-cms-redirects)[pagemachine/searchable

TYPO3 extension to index and search content with Elasticsearch

1039.9k](/packages/pagemachine-searchable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
