🎯 What This Guide Does
Instead of following static instructions, this guide provides copy-paste prompts that you can send to Claude (in any Claude interface - web, desktop, mobile) to get live, interactive guidance through the entire n8n MCP server installation process.
Claude will:
- ✅ Guide you step-by-step through your specific operating system
- ✅ Help troubleshoot issues in real-time
- ✅ Adapt to your specific setup and problems
- ✅ Answer questions as they come up
- ✅ Verify each step worked before moving to the next
📋 Before You Start
Make sure you have:
- Claude Desktop app installed (or access to Claude via web/mobile)
- About 30-45 minutes
- Administrator access to your computer
WINDOWS USERS: Copy-Paste Prompts
Copy this entire prompt and paste it to Claude:
<task>
I need to install the n8n MCP (Model Context Protocol) server to work with Claude Desktop on Windows. I want you to be my personal technical guide through this entire process.
Please start by reading the latest installation information from this GitHub repository: https://github.com/leonardsellem/n8n-mcp-server
<requirements>
- Guide me step-by-step for Windows
- Check if each step worked before moving to the next
- Help me troubleshoot any issues
- Explain what each step does in plain English
- Ask me to confirm each step before proceeding
</requirements>
<my_system>
Operating System: Windows
Technical Level: [Tell me: Are you comfortable with command line? Scale 1-10]
Current n8n setup: [Tell me: Do you have n8n running? If yes, where? (localhost:5678, cloud, etc.)]
</my_system>
</task>
First, please:
1. Fetch the latest info from the GitHub repository
2. Tell me what we're going to install and why
3. Check what I need to have ready
4. Start with step 1: Node.js installation
Guide me through each step one at a time, and ask me to tell you the result before moving forward.
Use this prompt if something goes wrong:
<troubleshooting>
I'm having an issue during the n8n MCP server installation on Windows.
<current_situation>
[Describe exactly what happened - what command you ran, what error you got, etc.]
</current_situation>
<system_info>
Windows Version: [Check: Windows 10, 11, etc.]
What I was trying to do: [Describe the specific step]
Error message: [Copy the exact error message if any]
</system_info>
Please help me:
1. Diagnose what went wrong
2. Provide the specific solution for my situation
3. Give me the exact commands to run
4. Verify the fix worked before continuing
5. Continue with the installation from where we left off
Be very specific with Windows commands and file paths.
</troubleshooting>
Use this after installation to configure Claude Desktop:
<configuration>
I've successfully installed the n8n MCP server on Windows and now need to configure Claude Desktop to use it.
<current_status>
✅ Node.js installed: [Confirm version]
✅ n8n MCP server installed: [Confirm it responded to --help]
✅ n8n API key obtained: [Confirm you have your API key]
My n8n details:
- n8n URL: [Example: http://localhost:5678 or https://your-n8n.com]
- API key: [I have this ready]
</current_status>
Please guide me through:
1. Finding the Claude Desktop config file on Windows
2. Creating or editing the claude_desktop_config.json file
3. Adding the exact configuration with my specific details
4. Testing that everything works together
5. Troubleshooting if the connection fails
Give me exact file paths, exact JSON configuration, and exact commands for Windows.
</configuration>
MAC USERS: Copy-Paste Prompts
Copy this entire prompt and paste it to Claude:
<task>
I need to install the n8n MCP (Model Context Protocol) server to work with Claude Desktop on Mac. I want you to be my personal technical guide through this entire process.
Please start by reading the latest installation information from this GitHub repository: https://github.com/leonardsellem/n8n-mcp-server
<requirements>
- Guide me step-by-step for macOS
- Check if each step worked before moving to the next
- Help me troubleshoot any issues
- Explain what each step does in plain English
- Ask me to confirm each step before proceeding
</requirements>
<my_system>
Operating System: macOS [Tell me: What version? Check Apple Menu > About This Mac]
Technical Level: [Tell me: Are you comfortable with Terminal? Scale 1-10]
Current n8n setup: [Tell me: Do you have n8n running? If yes, where? (localhost:5678, cloud, etc.)]
</my_system>
</task>
First, please:
1. Fetch the latest info from the GitHub repository
2. Tell me what we're going to install and why
3. Check what I need to have ready
4. Start with step 1: Node.js installation
Guide me through each step one at a time, and ask me to tell you the result before moving forward.
Use this prompt if something goes wrong:
<troubleshooting>
I'm having an issue during the n8n MCP server installation on Mac.
<current_situation>
[Describe exactly what happened - what command you ran, what error you got, etc.]
</current_situation>
<system_info>
macOS Version: [Check: Monterey, Ventura, Sonoma, etc.]
What I was trying to do: [Describe the specific step]
Error message: [Copy the exact error message if any]
Terminal output: [Copy any relevant terminal output]
</system_info>
Please help me:
1. Diagnose what went wrong
2. Provide the specific solution for my situation
3. Give me the exact commands to run (including sudo if needed)
4. Verify the fix worked before continuing
5. Continue with the installation from where we left off
Be very specific with macOS commands, file paths, and permission handling.
</troubleshooting>
Use this after installation to configure Claude Desktop:
<configuration>
I've successfully installed the n8n MCP server on Mac and now need to configure Claude Desktop to use it.
<current_status>
✅ Node.js installed: [Confirm version]
✅ n8n MCP server installed: [Confirm it responded to --help]
✅ n8n API key obtained: [Confirm you have your API key]
My n8n details:
- n8n URL: [Example: http://localhost:5678 or https://your-n8n.com]
- API key: [I have this ready]
</current_status>
Please guide me through:
1. Finding the Claude Desktop config file on Mac
2. Creating or editing the claude_desktop_config.json file
3. Adding the exact configuration with my specific details
4. Testing that everything works together
5. Troubleshooting if the connection fails
Give me exact file paths, exact JSON configuration, and exact Terminal commands for macOS.
</configuration>
UNIVERSAL PROMPTS (Both Windows & Mac)
Use this for complex issues or if multiple things are broken:
<advanced_help>
I need comprehensive help with my n8n MCP server setup. Multiple things might be wrong.
<full_situation>
Operating System: [Windows/Mac + version]
Installation method used: [npm global install / from source / other]
Current issue: [Describe the main problem]
What's working:
- [List anything that IS working]
What's not working:
- [List everything that's broken or not responding]
Error messages:
- [Include ALL error messages you're seeing]
What I've tried:
- [List any troubleshooting steps you've already attempted]
</full_situation>
I need you to:
1. Read the latest GitHub repository info to get current best practices
2. Diagnose ALL the issues systematically
3. Give me a complete recovery plan
4. Walk through each fix step-by-step
5. Test each component individually
6. Get everything working together
Please be thorough and methodical - I want to understand what went wrong and how to prevent it in the future.
</advanced_help>
Use this to verify everything is working correctly:
<verification>
I want to thoroughly test my n8n MCP server installation with Claude Desktop to make sure everything is working properly.
<setup_details>
Operating System: [Your OS]
Installation complete: [Yes/No/Partially]
Configuration file: [Created and saved]
Claude Desktop: [Restarted after config changes]
</setup_details>
Please help me:
1. Test the basic connection between Claude and n8n
2. Verify I can list my n8n workflows
3. Test creating a simple workflow through Claude
4. Check that API permissions are working correctly
5. Verify webhook functionality (if I want to use it)
6. Give me a list of example commands I can try
7. Show me what successful responses should look like
Walk me through comprehensive testing so I know everything is working properly.
</verification>
Use this after everything is working to learn what you can do:
<exploration>
My n8n MCP server is now working with Claude Desktop! I want to learn what I can do with this powerful combination.
<my_interests>
I'm particularly interested in: [Tell Claude what you want to automate - email, data processing, notifications, etc.]
My technical level: [Beginner/Intermediate/Advanced]
My n8n experience: [New to n8n / Some experience / Advanced user]
</my_interests>
Please help me:
1. Understand the key capabilities of this integration
2. Show me practical examples I can try right now
3. Teach me the most useful commands for managing workflows
4. Give me ideas for automation projects I could build
5. Explain best practices for using Claude with n8n
6. Provide some starter workflow examples I could create
Make this educational and hands-on - I want to really understand the power of what I just set up!
</exploration>
🎓 Why This Approach Works Better
✅ Advantages of Claude-Guided Installation
Compared to static documentation:
- Real-time adaptation: Claude reads the latest GitHub info and adapts to your specific situation
- Interactive troubleshooting: Get help for your exact error messages and system configuration
- Step-by-step verification: Claude checks each step worked before proceeding
- Personalized guidance: Adjusts explanations to your technical level
- Current information: Always uses the latest installation methods and best practices
📚 Built on Prompt Engineering Best Practices
These prompts use proven techniques:
- Clear role definition: Claude becomes your technical guide
- Structured input: XML tags organize information clearly
- Chain of thought: Claude thinks through problems step-by-step
- Context preservation: Each prompt builds on previous interactions
- Specific instructions: Clear, actionable guidance
- Error handling: Built-in troubleshooting workflows
🔄 How to Use These Prompts
- Start fresh: Use Prompt 1 for your OS to begin
- One conversation: Keep everything in the same Claude conversation for context
- Follow Claude's lead: Let Claude guide the pace and check each step
- Be specific: When Claude asks for information, be detailed and accurate
- Copy exact commands: Use exactly what Claude provides
- Test thoroughly: Use the verification prompt when done
🆘 If You Get Stuck
- Use the troubleshooting prompts with exact error messages
- Stay in the same conversation with Claude for context
- Be patient - Claude can solve complex technical issues step-by-step
- Don't skip Claude's verification steps
🚀 Ready to Start?
Pick your operating system above and copy-paste Prompt 1 to get started. Claude will take care of the rest, guiding you through a successful installation with personalized support every step of the way!