{"_id":"@brett_langdon/n8n-nodes-claudecode","_rev":"2-160ff49a4e5e90d68aa12f2ac9b95d5e","name":"@brett_langdon/n8n-nodes-claudecode","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@brett_langdon/n8n-nodes-claudecode","version":"0.1.0","keywords":["n8n-community-node-package","n8n","claude","claude-code","ai","anthropic","mcp","model-context-protocol"],"author":{"name":"Brett Langdon","email":"me@brett.is"},"license":"MIT","_id":"@brett_langdon/n8n-nodes-claudecode@0.1.0","maintainers":[{"name":"brett_langdon","email":"brett@blangdon.com"}],"homepage":"https://github.com/brettlangdon/n8n-nodes-claudecode#readme","bugs":{"url":"https://github.com/brettlangdon/n8n-nodes-claudecode/issues"},"n8n":{"nodes":["dist/nodes/ClaudeCode/ClaudeCode.node.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"c26e0a7d5245048c38d691605a769ada047684f2","tarball":"https://registry.npmjs.org/@brett_langdon/n8n-nodes-claudecode/-/n8n-nodes-claudecode-0.1.0.tgz","fileCount":12,"integrity":"sha512-OZymwgBfaZb5rUW09q0PL0CuRwQDeQCw/MD4mphQtaC9DagpdwbCmKi9KxUOBMou3lAH1sxes1q6GJzyTX2PPg==","signatures":[{"sig":"MEQCICPim/cKBUMMqnDAXunq43Si7SIPZCQMzPLz+aWeUiuUAiB+EdaJq/7DfdcrIIVDhNb4SuQzRCHXCEx2GWaxsmDTnA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":131330},"main":"index.js","config":{"commitizen":{"path":"./node_modules/cz-conventional-changelog"}},"engines":{"node":">=20.15"},"gitHead":"bde4e73cbffb0d58bf1e71a3c49f2e6a2183a4df","scripts":{"dev":"tsc --watch","lint":"eslint nodes package.json","build":"npm run format:check && npx rimraf dist && tsc && gulp build:icons && gulp build:schemas","commit":"cz","format":"prettier nodes --write","lintfix":"eslint nodes package.json --fix","format:check":"prettier nodes --check","prepublishOnly":"npm run build && npm run lint -c .eslintrc.prepublish.js nodes package.json"},"_npmUser":{"name":"brett_langdon","email":"brett@blangdon.com"},"repository":{"url":"git+https://github.com/brettlangdon/n8n-nodes-claudecode.git","type":"git"},"_npmVersion":"11.4.2","description":"n8n node for Claude Code SDK integration with MCP support","directories":{},"_nodeVersion":"23.5.0","dependencies":{"@anthropic-ai/claude-agent-sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"gulp":"^5.0.0","eslint":"^8.57.0","prettier":"^3.5.3","commitizen":"^4.3.1","typescript":"^5.8.2","@types/node":"^22.13.10","semantic-release":"^24.2.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^12.0.1","@semantic-release/github":"^11.0.1","@typescript-eslint/parser":"~8.32.0","cz-conventional-changelog":"^3.0.1","@semantic-release/changelog":"^6.0.3","eslint-plugin-n8n-nodes-base":"^1.16.3","@semantic-release/commit-analyzer":"^13.0.0","@semantic-release/release-notes-generator":"^14.0.1","conventional-changelog-conventionalcommits":"^8.0.0"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-claudecode_0.1.0_1760838114189_0.6706786896928112","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@brett_langdon/n8n-nodes-claudecode","version":"0.2.0","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/brettlangdon/n8n-nodes-claudecode#readme","bugs":{"url":"https://github.com/brettlangdon/n8n-nodes-claudecode/issues"},"author":{"name":"Brett Langdon","email":"me@brett.is"},"repository":{"type":"git","url":"git+https://github.com/brettlangdon/n8n-nodes-claudecode.git"},"engines":{"node":">=20.15"},"main":"index.js","scripts":{"build":"npm run format:check && npx rimraf dist && tsc && gulp build:icons && gulp build:schemas","format:check":"prettier nodes --check","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","commit":"cz"},"n8n":{"n8nNodesApiVersion":1,"nodes":["dist/nodes/ClaudeCode/ClaudeCode.node.js"]},"dependencies":{"@anthropic-ai/claude-agent-sdk":"latest"},"devDependencies":{"@semantic-release/changelog":"^6.0.3","@semantic-release/commit-analyzer":"^13.0.0","@semantic-release/git":"^10.0.1","@semantic-release/github":"^11.0.1","@semantic-release/npm":"^12.0.1","@semantic-release/release-notes-generator":"^14.0.1","@types/node":"^22.13.10","@typescript-eslint/parser":"~8.32.0","commitizen":"^4.3.1","conventional-changelog-conventionalcommits":"^8.0.0","cz-conventional-changelog":"^3.0.1","eslint":"^8.57.0","eslint-plugin-n8n-nodes-base":"^1.16.3","gulp":"^5.0.0","prettier":"^3.5.3","semantic-release":"^24.2.0","typescript":"^5.8.2"},"peerDependencies":{"n8n-workflow":"*"},"config":{"commitizen":{"path":"./node_modules/cz-conventional-changelog"}},"_id":"@brett_langdon/n8n-nodes-claudecode@0.2.0","gitHead":"315356daa766b4188610e7c000668acdc74b7f1c","_nodeVersion":"23.5.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-T8QTNAYYa7zIkmdzdXmVrJ9SaMHTxjOkaEfyybOQVuRUvK5TZpNUFD4lC3Whp0J/JgO0gYi0Ik+zN1CKydmWkg==","shasum":"d28349976bba5902580bf06e6fbb10dac95e0648","tarball":"https://registry.npmjs.org/@brett_langdon/n8n-nodes-claudecode/-/n8n-nodes-claudecode-0.2.0.tgz","fileCount":12,"unpackedSize":131631,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCXAXdAUWkOeC7ZLmsLPrAYniO4hHb1Di2Vo5kjTHyx0gIhAIUeOJ/osgzZIpNrIJs1a1DC6q39vJnO0wzp1DIDWQF2"}]},"_npmUser":{"name":"brett_langdon","email":"brett@blangdon.com"},"directories":{},"maintainers":[{"name":"brett_langdon","email":"brett@blangdon.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-claudecode_0.2.0_1760838314003_0.06941956655484094"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-19T01:41:54.093Z","modified":"2025-10-19T01:45:14.413Z","0.1.0":"2025-10-19T01:41:54.383Z","0.2.0":"2025-10-19T01:45:14.208Z"},"bugs":{"url":"https://github.com/brettlangdon/n8n-nodes-claudecode/issues"},"author":{"name":"Brett Langdon","email":"me@brett.is"},"license":"MIT","homepage":"https://github.com/brettlangdon/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/brettlangdon/n8n-nodes-claudecode.git"},"description":"n8n node for Claude Code SDK integration with MCP support","maintainers":[{"name":"brett_langdon","email":"brett@blangdon.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/@johnlindquist/n8n-nodes-claudecode.svg)](https://www.npmjs.com/package/@johnlindquist/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: `@johnlindquist/n8n-nodes-claudecode`\n5. Click **Install**\n6. Restart n8n when prompted\n\n#### Option 2: Manual Installation\n```bash\ncd ~/.n8n/nodes\nnpm install @johnlindquist/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=@johnlindquist/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**: [@johnlindquist/n8n-nodes-claudecode](https://www.npmjs.com/package/@johnlindquist/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### **Advanced SDK Options**\nFine-tune Claude Code's behavior with these powerful options:\n- šŸš« **Disallowed Tools**: Explicitly block specific tools for security\n- šŸ”„ **Fallback Model**: Automatically switch models when primary is overloaded\n- šŸ§  **Max Thinking Tokens**: Control Claude's internal reasoning depth\n- šŸ” **Permission Modes**: Choose from `default`, `acceptEdits`, `bypassPermissions`, or `plan`\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\n### Advanced Configuration with SDK Options\n```javascript\n{\n \"operation\": \"query\",\n \"prompt\": \"Refactor this legacy code to use modern patterns\",\n \"projectPath\": \"/path/to/legacy-app\",\n \"model\": \"opus\",\n \"allowedTools\": [\"Read\", \"Write\", \"Edit\", \"MultiEdit\", \"Grep\"],\n \"disallowedTools\": [\"Bash\"], // Prevent command execution for safety\n \"additionalOptions\": {\n \"permissionMode\": \"plan\", // Claude will plan before executing\n \"fallbackModel\": \"sonnet\", // Auto-switch if Opus is overloaded\n \"maxThinkingTokens\": 50000, // Allow deep reasoning for complex refactoring\n \"systemPrompt\": \"Preserve all existing functionality while modernizing the code\"\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/johnlindquist/n8n-nodes-claudecode)\n- šŸ› [Report Issues](https://github.com/johnlindquist/n8n-nodes-claudecode/issues)\n- šŸ’¬ [Discussions](https://github.com/johnlindquist/n8n-nodes-claudecode/discussions)\n- šŸŒŸ [Star on GitHub](https://github.com/johnlindquist/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## šŸ”„ Development & Contributing\n\n### Commit Conventions\n\nThis project uses [Conventional Commits](https://www.conventionalcommits.org/) and automated semantic versioning:\n\n- `feat:` New features (minor version bump)\n- `fix:` Bug fixes (patch version bump)\n- `docs:` Documentation changes\n- `chore:` Maintenance tasks\n- `test:` Adding or updating tests\n\nUse `npm run commit` for an interactive commit message builder.\n\n### Release Process\n\nReleases are **fully automated** using semantic-release:\n1. Push commits to `main` branch\n2. CI analyzes commit messages\n3. Version is automatically bumped based on commit types\n4. Package is published to npm\n5. GitHub release is created with changelog\n\nNo manual version management required!\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\nOriginally created by [Adam Holt](https://github.com/holt-web-ai) - [Original Repository](https://github.com/holt-web-ai/n8n-nodes-claudecode)\n\nForked and maintained by [John Lindquist](https://github.com/johnlindquist)","readmeFilename":"README.md"}