Skip to content
Back to search

typo3-mcp-server

One MCP endpoint connects your TYPO3 site to Claude, Cursor, n8n, and any AI tool — safely through workspaces.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hauptsacheNet/typo3-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hauptsacheNet/typo3-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hauptsachenet--typo3-mcp-server/badge.svg)](/listings/hauptsachenet--typo3-mcp-server)

HTML

<a href="/listings/hauptsachenet--typo3-mcp-server"><img src="/api/listings/hauptsachenet--typo3-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

composer require hn/typo3-mcp-server

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

Configuration

The defaults work out of the box. All settings live in the extension configuration (**Admin Tools → Settings → Extension Configuration → mcp_server**):

| Setting | Default | Purpose | |------------------------------|---------------------|---------| | `maxFileSizeMb` | `500` | Upper limit in MiB for files fetched from a URL or received through an upload link | | `additionalReadOnlyTables` | `sys_file` | Non-workspace-capable tables exposed read-only — this is what lets the AI browse your files | | `additionalStandaloneTables` | `sys_file_metadata` | `hideTable` tables exposed as independent tables — this is what makes file metadata such as titles and alt texts editable |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # TYPO3 MCP Server Extension
  2. This extension provides a Model Context Protocol (MCP) server implementation for TYPO3 that allows
  3. AI assistants to safely view and manipulate TYPO3 pages and records through TYPO3's workspace system.
  4. ## 🔒 Safe AI Content Management with Workspaces
  5. **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.
  6. ## 🧪 Continuously Tested With Real LLMs
  7. Every push to `main` runs a benchmark that has the latest models from **Anthropic, OpenAI, Mistral, and Google**, plus open-weight models from **Z.ai, DeepSeek, and Qwen**, 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.
  8. [
  9. ![haiku-5.5](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22haiku-5.5%22%5D&suffix=%25&label=haiku-5.5)
  10. ![gpt-6-luna](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22gpt-6-luna%22%5D&suffix=%25&label=gpt-6-luna)
  11. ![mistral-large-4](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22mistral-large-4%22%5D&suffix=%25&label=mistral-large-4)
  12. ![gemini-3.8-flash](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22gemini-3.8-flash%22%5D&suffix=%25&label=gemini-3.8-flash)
  13. ![glm-5.3-flash](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22glm-5.3-flash%22%5D&suffix=%25&label=glm-5.3-flash)
  14. ![deepseek-v4.1-flash](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22deepseek-v4.1-flash%22%5D&suffix=%25&label=deepseek-v4.1-flash)
  15. ![qwen3.8-27b](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fscript.google.com%2Fmacros%2Fs%2FAKfycbwyS4NavPMDQWbQQYCh3uKA4zJ5C8sxggxTZQQPdgjXOZ7Vt4BpUd5mzWdsWMqjzniI%2Fexec&query=%24.percentages%5B%22qwen3.8-27b%22%5D&suffix=%25&label=qwen3.8-27b)
  16. ](https://docs.google.com/spreadsheets/d/18jL34ymMaUfoCtL32FauPu3n0cTbBTLKuVO7dmGSAS4/edit?usp=sharing)
  17. ## What Can You Do?
  18. With the TYPO3 MCP Server, your AI assistant can help you:
  19. ### 📝 **Content Management**
  20. - **Translate Pages**: "Translate the /about-us page to German" - The AI reads your content, translates it, and creates proper language versions
  21. - **Import Documents**: "Create a news article from this Word document" - Transform external documents into TYPO3 content with proper structure
  22. - **Bulk Updates**: "Update all product descriptions to include our new sustainability message" - Make consistent changes across multiple pages
  23. ### 🔍 **Content Analysis & SEO**
  24. - **SEO Optimization**: "Add meta descriptions to all pages that don't have them" - Automatically generate missing SEO content based on page content
  25. - **Tone Analysis**: "Review the tone of our product pages and make them more friendly" - Get suggestions for improving content voice and style
  26. - **Content Audit**: "Find all pages mentioning our old company name" - Quickly locate content that needs updating
  27. ### 🚀 **Productivity Boosters**
  28. - **Template Application**: "Apply our standard legal disclaimer to all service pages" - Consistently apply content patterns
  29. - **Content Migration**: "Copy all news articles from 2023 to the archive folder" - Reorganize content efficiently
  30. - **Multi-language Management**: "Ensure all German pages have English translations" - Identify and fill translation gaps
  31. ### 🖼️ **Images, Videos & Files**
  32. - **Add Images From the Web**: "Put this image on our homepage: https://example.org/press/team.jpg" - The AI downloads the file into your file storage and creates the content element that shows it
  33. - **Embed Videos**: "Put this video on the home page: https://www.youtube.com/watch?v=..." - YouTube and Vimeo links become proper TYPO3 online media assets
  34. - **Add Text-Based Documents**: "Add this price list as a CSV download on the service page" - Text formats like SVG, CSV or subtitles can be uploaded directly as content
  35. - **Upload From Your Machine**: "Upload the team photo from my Desktop and add it to the about page" - You get a single-use upload link, so the file goes directly to TYPO3 instead of through the AI's context
  36. All these operations happen safely in workspaces, giving you full control to review before publishing!
  37. > 💡 **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.
  38. ## Project Status
  39. | Feature | Status | Notes |
  40. |---------------------------------|-----------------|-------|
  41. | **MCP Connection** | ✅ Ready | HTTP and stdin/stdout protocols (thanks to [logiscape/mcp-sdk-php](https://github.com/logiscape/mcp-sdk-php)) |
  42. | **Authentication** | ✅ Ready | OAuth for Backend Users |
  43. | **Page Tree Navigation** | ✅ Ready | Page tree view similar to the TYPO3 backend |
  44. | **Page Content Discovery** | ✅ Ready | Similar to the List or Page module with backend layout support |
  45. | **Record Reading/Writing** | ✅ Ready | Read and write any workspace-capable TYPO3 table (core & extensions) with full schema inspection |
  46. | **Content Translation** | ⚠️ Experimental | Implemented, needs real-world testing |
  47. | **File Upload** | ✅ Ready | From a URL, a YouTube/Vimeo link, raw text content, or a local file via single-use upload URL. Create-only: never overwrites or deletes, identical content is detected, executable files are refused |
  48. | **File Discovery & References** | ⚠️ Partial | Browse `sys_file` and metadata within the user's file mounts (incl. public URLs), edit metadata, create file references. No visual or semantic image search yet |
  49. | **Workspace Selection** | ❌ Missing | Currently uses the first writable workspace of the user |
  50. While 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).
  51. ## 🖼️ Files and Images
  52. Your assistant can bring new files into TYPO3, and it picks the right of these four ways on its own:
  53. - **From a URL**: the TYPO3 server downloads the file itself, so the file never has to pass through the AI.
  54. - **From YouTube or Vimeo**: those links become proper TYPO3 online media assets — the video itself stays where it is.
  55. - **Directly as content**: text-based documents like SVG, CSV or subtitle files can be uploaded as content, without a URL or a separate upload.
  56. - **From your own computer**: the assistant hands out a single-use upload link, and your MCP client sends the file directly to TYPO3. Binary data never travels through the AI's context, which keeps large photos both cheap and private.
  57. Uploading is deliberately **create-only** — nothing you already have can be overwritten or deleted. A name that is already taken is resolved by renaming (`image.jpg` becomes `image_01.jpg`), and uploading content that already exists returns the existing file instead of creating a duplicate. Files that could be executed, by the server or by a visitor's browser, are refused, as are files that reconfigure the web server. Downloads only work from public http(s) addresses, and your backend user's file mounts and file permissions apply throughout.
  58. Unlike records, files are not workspace-versioned in TYPO3, so an uploaded file lands in your file storage right away. It only becomes visible on the website once a record references it — and that reference *is* workspace-staged, so the usual review before publishing still applies.
  59. > 💡 See [Put this image on the homepage](TECHNICAL_OVERVIEW.md#put-this-image-on-the-homepage) in the Technical Overview for the actual tool calls, and [Image/File Handling](TECHNICAL_OVERVIEW.md#imagefile-handling) for the upload-token flow and the current limits.
  60. ## Installation
  61. ```bash
  62. composer require hn/typo3-mcp-server
  63. ```
  64. **Requirements:**
  65. - TYPO3 v13.4+
  66. - TYPO3 Workspaces extension (automatically installed as dependency)
  67. ### Configuration
  68. The defaults work out of the box. All settings live in the extension configuration
  69. (**Admin Tools → Settings → Extension Configuration → mcp_server**):
  70. | Setting | Default | Purpose |
  71. |------------------------------|---------------------|---------|
  72. | `maxFileSizeMb` | `500` | Upper limit in MiB for files fetched from a URL or received through an upload link |
  73. | `additionalReadOnlyTables` | `sys_file` | Non-workspace-capable tables exposed read-only — this is what lets the AI browse your files |
  74. | `additionalStandaloneTables` | `sys_file_metadata` | `hideTable` tables exposed as independent tables — this is what makes file metadata such as titles and alt texts editable |
  75. | `excludedTables` | *(empty)* | Tables the MCP never exposes, whatever the backend user may access (admins included). A trailing `*` matches a prefix. For tables with personal data that editors still need in the backend, e.g. `tx_powermail_domain_model_mail,tx_powermail_domain_model_answer` |
  76. | `allowedTables` | *(empty)* | If set, the MCP only exposes these tables (prefix `*` allowed), so tables of extensions added later stay hidden until listed. `excludedTables` wins. Empty means every table the user may access |
  77. | `workspacePreviewLinks` | `1` | Adds login-free workspace preview links to pages and records with unpublished changes, so the AI can show the result of its edits. Anyone with such a link sees all unpublished changes of the workspace until it expires |
  78. Records other than pages and content elements (news, events, ...) get a frontend URL once
  79. `TCEMAIN.preview.<table>` is configured in Page TSconfig — the same setting that powers the
  80. "View" button in the backend. See [Record URLs](Documentation/Architecture/RecordUrls.md).
  81. ## Usage
  82. ### Quick Start
  83. There are two ways to connect AI assistants like Claude Desktop to your TYPO3 installation:
  84. #### Option 1: OAuth Authentication (Recommended)
  85. For secure remote access with proper authentication:
  86. 1. Go to **[Username] → MCP Server** in your TYPO3 backend
  87. 2. Copy the Server URL (and optionally the Integration Name)
  88. 3. Add the Integration to whatever MCP Client you are using.
  89. ![MCP Server Setup](mcp_setup.png)
  90. The HTTP endpoint runs with the permissions of the logged-in backend user: DB mounts, table and field permissions, and workspaces apply as in the TYPO3 backend.
  91. #### Option 2: Local Command Line Connection (Deprecated)
  92. > [!WARNING]
  93. > The stdio command is deprecated. Use the HTTP endpoint (Option 1) instead.
  94. The stdio command always runs with admin privileges. This is intended: running it requires shell access to the server, which already means full control over the TYPO3 installation. It also only works where the MCP client can start a process on the server. To use it anyway, add this to the MCP config file of Claude Desktop or whatever client you are using:
  95. ```json
  96. {
  97. "mcpServers": {
  98. "[your-typo3-name]": {
  99. "command": "php",
  100. "args": [
  101. "vendor/bin/typo3",
  102. "mcp:server"
  103. ]
  104. }
  105. }
  106. }
  107. ```
  108. ## Development
  109. ### Running Tests
  110. ```bash
  111. # Functional tests (PHPUnit)
  112. composer test
  113. # E2E tests — spins up MySQL, TYPO3, and Playwright in Docker
  114. Build/runTests.sh -s e2e
  115. # E2E without Docker (host PHP + SQLite + local Playwright).
  116. # Auto-selected when Docker is unavailable.
  117. Build/runTests.sh -s e2e --no-docker
  118. # E2E against an existing TYPO3 instance
  119. TYPO3_BASE_URL=https://my.ddev.site Build/runTests.sh -s e2e
  120. # See all options
  121. Build/runTests.sh -h
  122. ```
  123. ### Adding New Tools
  124. Tools are defined in the `Classes/MCP/Tool` directory. Each tool follows the MCP tool specification and maps to specific TYPO3 functionality.
  125. ## Learn More
  126. - 📖 **[Technical Overview](TECHNICAL_OVERVIEW.md)** - Comprehensive guide covering architecture, implementation details, and advanced usage
  127. - 🏗️ **[Architecture Documentation](Documentation/Architecture/)** - Deep dives into specific implementation aspects:
  128. - [Workspace Transparency](Documentation/Architecture/WorkspaceTransparency.md) - How workspace complexity is hidden from AI
  129. - [Language Overlays](Documentation/Architecture/LanguageOverlays.md) - Multi-language content handling
  130. - [Inline Relations](Documentation/Architecture/InlineRelations.md) - Managing TYPO3's complex relation types
  131. - [Record URLs](Documentation/Architecture/RecordUrls.md) - Frontend URLs of records and workspace preview links
  132. ## License
  133. GPL-2.0-or-later

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.