Agent skill
n8n-setup
Configure n8n MCP server connection credentials (API key and base URL). Use when the user needs to set up or update their n8n API credentials.
Install this agent skill to your Project
npx add-skill https://github.com/visccyberacct/n8n-mcp-server/tree/main/skills/n8n-setup
SKILL.md
n8n Setup Skill
Guide users through configuring their n8n API credentials for the MCP server.
When to Use
- User mentions setting up n8n
- User asks how to configure n8n credentials
- User reports authentication errors with n8n
- User needs to change their n8n instance URL or API key
Setup Process
1. Collect Required Information
Ask the user for:
- n8n Base URL: The full URL of their n8n instance (e.g.,
https://n8n.homelab.com) - n8n API Key: Their n8n API key from Settings > API
2. Create/Update .env File
Create or update the .env file in the plugin root directory with:
N8N_BASE_URL=<user's n8n URL>
N8N_API_KEY=<user's API key>
Location: ${CLAUDE_PLUGIN_ROOT}/.env
3. Verify and Restart
After configuration:
- Inform user the credentials have been saved
- Remind them to restart Claude Code
- Suggest testing with: "List my n8n workflows"
Example Interaction
User: "How do I set up n8n?"
Assistant: "I'll help you configure the n8n MCP server. I need two pieces of information:
- n8n Instance URL: What's your n8n base URL? (e.g., https://n8n.homelab.com)
- API Key: What's your n8n API key? You can get this from n8n under Settings > API > Create API Key
Please provide these details."
User: "URL is https://n8n.homelab.com and key is n8n_api_abc123xyz..."
Assistant: [Creates/updates .env file at ${CLAUDE_PLUGIN_ROOT}/.env]
"✓ Configuration saved!
Next steps:
- Restart Claude Code for changes to take effect
- Test the connection: 'List my n8n workflows'
Your n8n instance at https://n8n.homelab.com is now configured."
Getting an API Key
Guide users to get their API key:
- Log into their n8n instance
- Go to Settings > API
- Click "Create API Key"
- Copy the generated key (they won't be able to see it again)
Security Notes
- Credentials are stored in
.env(not committed to git) - API keys should be kept secure and never shared
- If compromised, user should regenerate the key in n8n
- To update credentials, simply re-run this setup process
Troubleshooting
401 Unauthorized: API key is invalid or expired
- Verify the key is correct
- Regenerate key in n8n if needed
Connection refused: Cannot reach n8n instance
- Verify the base URL is correct
- Check network connectivity
- Ensure n8n instance is running
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
mattpocock/skills
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
mattpocock/skills
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
Didn't find tool you were looking for?