{"_id":"@bilalmubarik/n8n-nodes-claudecode","_rev":"2-56eea4b7bb99ff8aeafe20c2121a8a1c","name":"@bilalmubarik/n8n-nodes-claudecode","dist-tags":{"latest":"0.2.2"},"versions":{"0.2.1":{"name":"@bilalmubarik/n8n-nodes-claudecode","version":"0.2.1","keywords":["n8n-community-node-package","n8n","claude","claude-code","ai","anthropic","mcp","model-context-protocol"],"author":{"name":"Adam Holt","email":"adam@holtweb.co.nz"},"license":"MIT","_id":"@bilalmubarik/n8n-nodes-claudecode@0.2.1","maintainers":[{"name":"bilalmubarik","email":"belal.mubarik@gmail.com"}],"homepage":"https://github.com/bilalmubarik/n8n-nodes-claudecode#readme","bugs":{"url":"https://github.com/bilalmubarik/n8n-nodes-claudecode/issues"},"n8n":{"nodes":["dist/nodes/ClaudeCode/ClaudeCode.node.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"e3dabe8fa3becc9913a9bd966f79a0c032e29109","tarball":"https://registry.npmjs.org/@bilalmubarik/n8n-nodes-claudecode/-/n8n-nodes-claudecode-0.2.1.tgz","fileCount":10,"integrity":"sha512-YNuevUxhlkX9soBgN351pykJQJlNPWzIb+TxEG5kK8BJb5stjj1PGRxf142UXGHx+wdlrBd+FDRQNW4ttSD+7Q==","signatures":[{"sig":"MEUCIQD3oRtNcpx5JbA8EQKYXhuXeuDrQ4FmhBxLaAtEIE3w6gIgfg+ewJPH35pJrhSGH+FlheyfJfJfh5tU53SNePslhmk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95990},"main":"index.js","engines":{"node":">=20.15"},"gitHead":"4bd12f11bb503eacd497c2b19f9181177ff1faa9","scripts":{"dev":"tsc --watch","lint":"eslint nodes package.json","build":"npx rimraf dist && tsc && gulp build:icons","format":"prettier nodes --write","lintfix":"eslint nodes package.json --fix","prepublishOnly":"npm run build && npm run lint -c .eslintrc.prepublish.js nodes package.json"},"_npmUser":{"name":"bilalmubarik","email":"belal.mubarik@gmail.com"},"repository":{"url":"git+https://github.com/bilalmubarik/n8n-nodes-claudecode.git","type":"git"},"_npmVersion":"10.9.0","description":"n8n node for Claude Code SDK integration with MCP support","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@anthropic-ai/claude-agent-sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"gulp":"^5.0.0","eslint":"^8.57.0","prettier":"^3.5.3","typescript":"^5.8.2","@types/node":"^22.13.10","@typescript-eslint/parser":"~8.32.0","eslint-plugin-n8n-nodes-base":"^1.16.3"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-claudecode_0.2.1_1764521691085_0.6532369013897128","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bilalmubarik/n8n-nodes-claudecode","version":"0.2.2","description":"n8n node for Claude Code SDK integration with MCP support","keywords":["n8n-community-node-package","n8n","claude","claude-code","ai","anthropic","mcp","model-context-protocol"],"license":"MIT","homepage":"https://github.com/bilalmubarik/n8n-nodes-claudecode#readme","bugs":{"url":"https://github.com/bilalmubarik/n8n-nodes-claudecode/issues"},"author":{"name":"Adam Holt","email":"adam@holtweb.co.nz"},"repository":{"type":"git","url":"git+https://github.com/bilalmubarik/n8n-nodes-claudecode.git"},"engines":{"node":">=20.15"},"main":"index.js","scripts":{"build":"npx rimraf dist && tsc && gulp build:icons","dev":"tsc --watch","format":"prettier nodes --write","lint":"eslint nodes package.json","lintfix":"eslint nodes package.json --fix","prepublishOnly":"npm run build && npm run lint -c .eslintrc.prepublish.js nodes package.json"},"n8n":{"n8nNodesApiVersion":1,"nodes":["dist/nodes/ClaudeCode/ClaudeCode.node.js"]},"dependencies":{"@anthropic-ai/claude-agent-sdk":"latest"},"devDependencies":{"@types/node":"^22.13.10","@typescript-eslint/parser":"~8.32.0","eslint":"^8.57.0","eslint-plugin-n8n-nodes-base":"^1.16.3","gulp":"^5.0.0","prettier":"^3.5.3","typescript":"^5.8.2"},"peerDependencies":{"n8n-workflow":"*"},"_id":"@bilalmubarik/n8n-nodes-claudecode@0.2.2","gitHead":"4bd12f11bb503eacd497c2b19f9181177ff1faa9","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-lBmIpr/UUsyCmEu2ETXadhJ++W7FlqyLT/I/Hqvsw6CDO7q0ElgO3lgRW3dACVHQavEBPrasM3euU3tXYYIiVA==","shasum":"57b1507dab7e2a96aaff4c52e0966191493b841d","tarball":"https://registry.npmjs.org/@bilalmubarik/n8n-nodes-claudecode/-/n8n-nodes-claudecode-0.2.2.tgz","fileCount":10,"unpackedSize":101243,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDSH09hjT3wsuTenhEvWsPs6ErSrtpLa5cfEovqM2waNgIgV36wBlBA5zHfVAqTT4Rm4U40G3YIPQ8glB+XOCmlo2E="}]},"_npmUser":{"name":"bilalmubarik","email":"belal.mubarik@gmail.com"},"directories":{},"maintainers":[{"name":"bilalmubarik","email":"belal.mubarik@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-claudecode_0.2.2_1764861992412_0.6591725888221713"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-30T16:54:51.012Z","modified":"2025-12-04T15:26:32.758Z","0.2.1":"2025-11-30T16:54:51.271Z","0.2.2":"2025-12-04T15:26:32.549Z"},"bugs":{"url":"https://github.com/bilalmubarik/n8n-nodes-claudecode/issues"},"author":{"name":"Adam Holt","email":"adam@holtweb.co.nz"},"license":"MIT","homepage":"https://github.com/bilalmubarik/n8n-nodes-claudecode#readme","keywords":["n8n-community-node-package","n8n","claude","claude-code","ai","anthropic","mcp","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/bilalmubarik/n8n-nodes-claudecode.git"},"description":"n8n node for Claude Code SDK integration with MCP support","maintainers":[{"name":"bilalmubarik","email":"belal.mubarik@gmail.com"}],"readme":"# 🚀 Claude Code for n8n\n\n**Bring the power of Claude Code directly into your n8n automation workflows!**\n\nImagine having an AI coding assistant that can analyze your codebase, fix bugs, write new features, manage databases, interact with APIs, and automate your entire development workflow - all within n8n. That's exactly what this node enables.\n\n[![n8n](https://img.shields.io/badge/n8n-community_node-orange.svg)](https://n8n.io/)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Powered-blue.svg)](https://claude.ai/code)\n[![npm](https://img.shields.io/npm/v/@bilalmubarik/n8n-nodes-claudecode.svg)](https://www.npmjs.com/package/@bilalmubarik/n8n-nodes-claudecode)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.md)\n\n## 🌟 What Can You Build?\n\n### 🔧 **Automated Code Reviews**\nCreate workflows that automatically review pull requests, suggest improvements, and even fix issues before merging.\n\n### 🐛 **Intelligent Bug Fixing**\nConnect error monitoring tools to Claude Code - automatically diagnose and fix production issues in real-time.\n\n### 📊 **Database Management**\nLet Claude Code write complex SQL queries, optimize database schemas, and generate migration scripts based on your requirements.\n\n### 🤖 **Self-Improving Workflows**\nBuild n8n workflows that can modify and improve themselves using Claude Code's capabilities.\n\n### 📝 **Documentation Generation**\nAutomatically generate and update documentation for your entire codebase, APIs, or databases.\n\n### 🔄 **Code Migration**\nAutomate the migration of legacy codebases to modern frameworks with intelligent refactoring.\n\n### 🎫 **Customer Support Automation**\nTransform support tickets into code fixes automatically:\n- Analyze customer bug reports and reproduce issues\n- Generate fixes for reported problems\n- Create test cases to prevent regression\n- Update documentation based on common questions\n- Auto-respond with workarounds while fixes are deployed\n\n## ⚡ Quick Start\n\n### Prerequisites\n1. **Claude Code CLI** (required on your n8n server):\n   ```bash\n   npm install -g @anthropic-ai/claude-code\n   claude  # Authenticate (requires Claude Pro/Team subscription)\n   ```\n\n### Install in n8n\n\n#### Option 1: Via n8n UI (Recommended)\n1. Open your n8n instance\n2. Go to **Settings** → **Community Nodes**\n3. Click **Install a community node**\n4. Enter: `@bilalmubarik/n8n-nodes-claudecode`\n5. Click **Install**\n6. Restart n8n when prompted\n\n#### Option 2: Manual Installation\n```bash\ncd ~/.n8n/nodes\nnpm install @bilalmubarik/n8n-nodes-claudecode\n# Restart n8n\n```\n\n#### Option 3: Docker\n```bash\ndocker run -it --rm \\\n  -p 5678:5678 \\\n  -e N8N_COMMUNITY_NODE_PACKAGES=@bilalmubarik/n8n-nodes-claudecode \\\n  -v ~/.n8n:/home/node/.n8n \\\n  n8nio/n8n\n```\n\n**Note**: For Docker, you'll need to ensure Claude Code CLI is installed inside the container. Consider creating a custom Dockerfile.\n\n📦 **NPM Package**: [@bilalmubarik/n8n-nodes-claudecode](https://www.npmjs.com/package/@bilalmubarik/n8n-nodes-claudecode)\n\n## 🎯 Real-World Use Cases\n\n### 1. **GitHub Issue to Code**\n```\nWebhook (GitHub Issue) → Claude Code → Create PR → Notify Slack\n```\nAutomatically implement features or fix bugs when issues are created.\n\n### 2. **Database Query Builder**\n```\nForm Trigger → Claude Code → Execute Query → Send Results\n```\nNatural language to SQL - let non-technical users query databases safely.\n\n### 3. **Code Quality Guardian**\n```\nGit Push → Claude Code → Analyze Code → Block/Approve → Notify\n```\nEnforce coding standards and catch issues before they reach production.\n\n### 4. **API Integration Builder**\n```\nHTTP Request → Claude Code → Generate Integration → Test → Deploy\n```\nAutomatically create integrations with third-party APIs.\n\n### 5. **Intelligent Log Analysis**\n```\nError Logs → Claude Code → Diagnose → Create Fix → Open PR\n```\nTurn error logs into actionable fixes automatically.\n\n### 6. **Customer Support to Code Fix**\n```\nSupport Ticket → Claude Code → Reproduce Issue → Generate Fix → Test → Deploy → Auto-Reply\n```\nTransform customer complaints into deployed fixes in minutes, not days.\n\n## 🛠️ Powerful Features\n\n### **Project Context Awareness**\nSet a project path and Claude Code understands your entire codebase context:\n- Analyzes existing code patterns\n- Follows your coding standards\n- Understands your architecture\n- Respects your dependencies\n\n### **Tool Arsenal**\nClaude Code comes equipped with powerful tools:\n- 📁 **File Operations**: Read, write, edit multiple files\n- 💻 **Bash Commands**: Execute any command\n- 🔍 **Smart Search**: Find patterns across your codebase\n- 🌐 **Web Access**: Fetch documentation and resources\n- 📊 **Database Access**: Via MCP servers\n- 🔗 **API Integration**: GitHub, Slack, and more via MCP\n\n### **Model Context Protocol (MCP)**\nExtend Claude Code with specialized capabilities:\n- PostgreSQL/MySQL database access\n- GitHub repository management\n- Slack workspace integration\n- Custom tool development\n\n## 📋 Configuration Examples\n\n### Simple Code Analysis\n```javascript\n{\n  \"operation\": \"query\",\n  \"prompt\": \"Analyze this codebase and suggest performance improvements\",\n  \"projectPath\": \"/path/to/your/project\",\n  \"model\": \"sonnet\"\n}\n```\n\n### Advanced Database Operations\n```javascript\n{\n  \"operation\": \"query\",\n  \"prompt\": \"Create an optimized query to find users who haven't logged in for 30 days\",\n  \"projectPath\": \"/path/to/project\",\n  \"model\": \"opus\"\n}\n```\n\n### Customer Support Automation\n```javascript\n{\n  \"operation\": \"query\",\n  \"prompt\": \"Customer reports: 'Login button not working on mobile devices'\\n\\nAnalyze this issue, find the root cause, and create a fix\",\n  \"projectPath\": \"/path/to/web-app\",\n  \"model\": \"opus\",\n  \"allowedTools\": [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\"],\n  \"additionalOptions\": {\n    \"systemPrompt\": \"Focus on mobile compatibility issues. Check responsive CSS and JavaScript event handlers.\"\n  }\n}\n```\n\nWith MCP configuration (`.mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"postgres\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-postgres\", \"${DATABASE_URL}\"]\n    }\n  }\n}\n```\n\n## 🔄 Workflow Patterns\n\n### Pattern 1: Continuous Code Improvement\n```\nSchedule Trigger (Daily)\n  ↓\nClaude Code (Analyze codebase for improvements)\n  ↓\nCreate GitHub Issues\n  ↓\nAssign to Team\n```\n\n### Pattern 2: Natural Language to Code\n```\nSlack Command\n  ↓\nClaude Code (Generate code from description)\n  ↓\nCreate Pull Request\n  ↓\nRun Tests\n  ↓\nNotify Results\n```\n\n### Pattern 3: Intelligent Monitoring\n```\nError Webhook\n  ↓\nClaude Code (Diagnose issue)\n  ↓\nIf (Can fix automatically)\n  ├─ Yes: Create Fix PR\n  └─ No: Create Detailed Issue\n```\n\n## 🚦 Getting Started\n\n### 1. **Verify Prerequisites**\nMake sure Claude Code CLI is installed and authenticated on your n8n server:\n```bash\nclaude --version  # Should show the version\n```\n\nIf not installed, see the [Quick Start](#-quick-start) section above.\n\n### 2. **Create Your First Workflow**\n1. In n8n, create a new workflow\n2. Add a **Manual Trigger** node (for testing)\n3. Add the **Claude Code** node\n4. Configure:\n   - **Operation**: Query\n   - **Prompt**: \"Analyze the code in this directory and suggest improvements\"\n   - **Project Path**: `/path/to/your/project`\n   - **Model**: Sonnet (faster) or Opus (more powerful)\n5. Click **Execute Workflow**\n6. Watch Claude Code analyze your project!\n\n### 3. **Explore Advanced Features**\n- Check out the [workflow templates](./workflow-templates/) for ready-to-use examples\n- See the [examples directory](./examples/) for configuration options\n- Read about [MCP servers](#model-context-protocol-mcp) for database and API access\n\n## 💡 Pro Tips\n\n### 🎯 **Use Project Paths**\nAlways set a project path for better context and results:\n```\n/home/user/projects/my-app\n```\n\n### 🔒 **Configure Permissions**\nControl what Claude Code can do in `.claude/settings.json`:\n```json\n{\n  \"permissions\": {\n    \"allow\": [\"Read(*)\", \"Write(*)\", \"Bash(npm test)\"],\n    \"deny\": [\"Bash(rm -rf *)\"]\n  }\n}\n```\n\n### 🔗 **Chain Operations**\nUse \"Continue\" operation to build complex multi-step workflows while maintaining context.\n\n### 📊 **Output Formats**\n- **Structured**: Full details with metrics\n- **Messages**: For debugging\n- **Text**: Simple results for chaining\n\n## 🤝 Community & Support\n\n- 📖 [Documentation](https://github.com/bilalmubarik/n8n-nodes-claudecode)\n- 🐛 [Report Issues](https://github.com/bilalmubarik/n8n-nodes-claudecode/issues)\n- 💬 [Discussions](https://github.com/bilalmubarik/n8n-nodes-claudecode/discussions)\n- 🌟 [Star on GitHub](https://github.com/bilalmubarik/n8n-nodes-claudecode)\n\n## 📈 What's Next?\n\nWe're constantly improving! Upcoming features:\n- Visual workflow builder for Claude Code operations\n- Pre-built workflow templates\n- Enhanced debugging tools\n- More MCP server integrations\n\n## 📄 License\n\nMIT - Build amazing things!\n\n---\n\n**Ready to revolutionize your development workflow?** Install Claude Code for n8n today and join the future of automated software development!\n\nMade with ❤️ by [Adam Holt](https://github.com/holt-web-ai)","readmeFilename":"README.md"}