Writing a blog post the traditional way goes something like this: research the topic in multiple browser tabs, draft the outline in a doc, write the full article, copy-paste it into the Joomla editor, format the headings, find an image, upload it, fill in the meta description, choose the category, set the publish date, hit publish.
It's not hard. It's just slow — and every step is manual.
With Claude AI connected to your Joomla site via a Joomla MCP server, the entire workflow collapses into a single conversation. You give Claude a topic, it researches, writes, uploads the image, and publishes — all without you leaving the chat.
This guide walks through exactly how to set that up and use it in practice, including the prompts that actually work.
What You Need Before Starting
This workflow requires three things to be in place:
- A Joomla 4 or 5 site with the REST API accessible (enabled by default)
- A Joomla MCP server configured and connected to your AI client
- Claude Desktop (or another MCP-compatible AI client) with the Joomla server registered
If you haven't set up the Joomla MCP server yet, start with our guide: Joomla MCP Server: What It Does and How to Set It Up. Come back here once your connection is tested and working.
The Full AI Content Workflow — Step by Step
Here's the complete flow from topic idea to published article, using Claude AI with the Joomla MCP server. Each step includes the exact prompt to use.
Step 1: Brief Claude on the Article
Start by giving Claude a clear brief. The more context you provide upfront, the less back-and-forth you'll need. A good brief covers the topic, target audience, tone, and any specific requirements.
Example prompt:
"Write a blog article for thepixel.dev. Topic: 'How to Speed Up a Joomla Site in 2026'. Target audience: Joomla site owners who are not developers. Tone: practical, clear, actionable. Target length: 1,800 words. Include real techniques, not generic advice. Format in clean HTML with H2/H3 headings, lists, and paragraphs."
Claude will write the full article. You can review it, ask for changes, or proceed straight to publishing.
Step 2: Check the Category
Before publishing, ask Claude to confirm where the article should go:
"List all categories on my Joomla site so I can choose the right one for this article."
Claude will call the Joomla MCP server, retrieve your category list, and present the options. You pick the right one by name — no need to look up category IDs manually.
Step 3: Find and Upload a Featured Image
Tell Claude what kind of image you want and where to put it:
"Find a suitable image for this article about Joomla speed optimization. Upload it to the Joomla media library at local-images:/blog/joomla-speed-optimization-2026.jpg — use a 600×400px crop from Unsplash."
Claude will select a relevant Unsplash photo, upload it via the MCP server, and confirm the media path so it can be attached to the article.
Step 4: Publish the Article
Once the content and image are ready, one final prompt publishes everything:
"Publish this article to Joomla. Category: Performance & Optimization. Set state to published. Use the image we just uploaded. Add a meta description summarizing the first paragraph. Mark it as featured."
Claude will call the Joomla MCP server's create_article tool with all the right parameters — title, body, category, image fields, metadata, state, and featured flag — and report back with the article ID and URL.
Start to finish: under 10 minutes for a 1,800-word, properly formatted, published Joomla article.
Prompting Tips for Better Joomla Content
The quality of the output depends heavily on the quality of the brief. Here are the prompting patterns that consistently produce better Joomla articles:
Be Specific About the Audience
Vague: "Write about Joomla security."
Better: "Write about Joomla security for agency owners who manage 5–10 client sites but aren't security experts. Focus on practical, actionable steps they can take this week."
The audience definition shapes everything: vocabulary, depth, examples, and tone.
Specify Internal Links
Tell Claude which existing articles to link to:
"Where relevant, link to these existing articles on the site: [paste URLs]. Only use these exact URLs — do not guess or construct new ones."
This is important. AI assistants sometimes invent URLs that look plausible but don't exist, creating 404 errors that hurt SEO. Giving Claude the real URLs eliminates this risk.
Request a Specific HTML Structure
"Format the article in clean HTML: <h2> for main sections, <h3> for sub-sections, <p> for paragraphs, <ul> or <ol> for lists, <strong> for emphasis. Do not include <html>, <head>, or <body> tags — just the body content."
Joomla's editor works with HTML, so specifying the exact format saves post-publish cleanup.
Ask for SEO Metadata Separately
"After the article, provide: (1) a meta description under 155 characters, (2) 3–5 SEO keywords separated by commas."
This way the metadata is ready to include in the publish command without an extra round-trip.
Use Iterative Refinement
Don't expect a perfect first draft every time. Claude responds well to targeted revision requests:
"The introduction is too generic — rewrite it with a more specific hook about the problem Joomla site owners face."
"Section 3 is too technical for a non-developer audience. Simplify it and add a real-world example."
"Add a comparison table between Option A and Option B in Section 4."
Treat it like working with a writer: give clear, specific feedback and you'll get good results quickly.
What Claude AI Can and Can't Do for Joomla Content
It's worth being clear about the boundaries of this workflow, so you know where human judgment is still needed.
What Works Well
- Writing structured, well-formatted long-form articles
- Creating SEO-optimized meta descriptions and title tags
- Following a detailed brief and style guide consistently
- Publishing to Joomla with correct category, image, metadata, and state
- Bulk operations: updating multiple articles, creating category structures
- Adapting tone for different audiences (technical vs. non-technical)
Where You Still Need Human Review
- Factual accuracy: Claude can hallucinate specifics — version numbers, plugin names, step sequences. Always verify technical claims before publishing.
- Brand voice: Unless you've given Claude detailed style guidelines and examples, the first draft may not perfectly match your tone. Refinement prompts help.
- Original insights: Claude synthesizes existing information well but doesn't generate genuinely new industry perspectives. Add your own experience where it matters.
- Real-time data: Claude's knowledge has a training cutoff. For anything time-sensitive (latest Joomla release notes, current plugin versions), supplement with your own research.
The practical approach: use Claude to handle the structure, formatting, and 80% of the writing — then spend 10–15 minutes on a human pass to verify facts, add original insights, and tune the voice. You'll still publish 3–5× faster than writing from scratch.
A Real Workflow Example
Here's a concrete example of how this plays out end to end. Context: writing an article about Joomla SEO for a client site.
Prompt 1 — Brief:
"Write a 2,000-word article titled 'Joomla SEO Checklist for 2026: 15 Steps to Better Rankings'. Audience: Joomla site owners who understand basic SEO but want a Joomla-specific checklist. Tone: authoritative, practical. Include a numbered checklist format for the main section. HTML output only."
Claude writes the full article in ~30 seconds.
Prompt 2 — Refinement:
"Items 7 and 11 overlap. Merge them and replace with a new checklist item about structured data / schema markup for Joomla."
Claude revises the relevant section.
Prompt 3 — Image:
"Upload a 600×400 Unsplash image representing SEO/search rankings to local-images:/blog/joomla-seo-checklist-2026.jpg"
Claude uploads via the MCP server and confirms the path.
Prompt 4 — Publish:
"Publish to Joomla. Category: Joomla (id 18). State: published. Featured: yes. Attach the image we just uploaded. Meta description: 'A 15-step Joomla SEO checklist for 2026 — covering technical SEO, metadata, speed, structured data, and content strategy for Joomla site owners.' "
Claude publishes and returns the article URL. Total time: under 8 minutes.
Scaling the Workflow Across Multiple Sites
One of the biggest advantages of this approach for agencies is that it scales across multiple Joomla sites without proportionally more effort. If you manage 10 client sites, each with its own MCP server registered in your AI client, you can:
- Switch between sites by naming them in your prompt ("on the ClientA Joomla site, create…")
- Run the same content brief across multiple sites with minor customizations
- Batch-update metadata or tags on multiple sites in sequence
- Maintain consistent content quality and structure across all properties
This is the kind of leverage that changes the economics of agency content work. For the technical foundation of how multi-site management works, revisit our Joomla MCP Server setup guide.
Conclusion
Claude AI + a Joomla MCP server isn't a replacement for thoughtful content strategy — it's a force multiplier for executing that strategy. The research, writing, formatting, image sourcing, metadata, and publishing that used to take hours now happens in a single, conversational workflow.
The teams and agencies that build this into their standard process will have a significant output advantage over those still doing everything manually. The tools are available now. The setup is straightforward. The time to start is today.
Want help configuring this workflow for your Joomla site or agency? Reach out to the ThePixel team — we've built this into our own content process and can help you do the same.