Interactive Claude-Guided Installation:
n8n MCP Server

Get personalized, real-time assistance from Claude to set up n8n with Claude Desktop

Step-by-Step Guidance
Claude guides you through your specific OS setup
🔧
Real-Time Troubleshooting
Get instant help for any issues that arise
🎯
Adaptive Instructions
Tailored to your technical level and setup

Interactive guide created by @alexbitar

🎯 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:

📚 Quick Navigation

📋 Before You Start

Make sure you have:

🖥️

WINDOWS USERS: Copy-Paste Prompts

Prompt 1 Initial Setup and Assessment

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.
Prompt 2 If You Run Into Issues

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>
Prompt 3 Configuration and Testing

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

Prompt 1 Initial Setup and Assessment

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.
Prompt 2 If You Run Into Issues

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>
Prompt 3 Configuration and Testing

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)

Advanced Troubleshooting Prompt

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>
Testing and Verification Prompt

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>
Learning and Exploration Prompt

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:

  1. Real-time adaptation: Claude reads the latest GitHub info and adapts to your specific situation
  2. Interactive troubleshooting: Get help for your exact error messages and system configuration
  3. Step-by-step verification: Claude checks each step worked before proceeding
  4. Personalized guidance: Adjusts explanations to your technical level
  5. Current information: Always uses the latest installation methods and best practices

📚 Built on Prompt Engineering Best Practices

These prompts use proven techniques:

🔄 How to Use These Prompts

  1. Start fresh: Use Prompt 1 for your OS to begin
  2. One conversation: Keep everything in the same Claude conversation for context
  3. Follow Claude's lead: Let Claude guide the pace and check each step
  4. Be specific: When Claude asks for information, be detailed and accurate
  5. Copy exact commands: Use exactly what Claude provides
  6. Test thoroughly: Use the verification prompt when done

🆘 If You Get Stuck

🚀 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!