n8n-nodes-kaiten-api

This is an n8n community node that provides integration with the Kaiten API for project management and Kanban board operations.

Features

• Dynamic UI Selects: Smart dropdowns that automatically load available spaces, boards, and columns
• Smart Selection: Select spaces, boards, and columns by name with automatic population
• Read Operations: Get cards, boards, spaces, columns, lanes, and user information
• Error Handling: Robust error handling with detailed error messages

Installation

Community Nodes (Recommended)

1. Go to Settings → Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-kaiten-api
4. Click Install

Manual Installation

# In your n8n root folder
npm install n8n-nodes-kaiten-api

Docker

Add the package to your n8n Docker setup:

FROM n8nio/n8n
RUN npm install -g n8n-nodes-kaiten-api

Configuration

Credentials

You need to set up Kaiten API credentials:

1. Server URL: Your Kaiten instance URL (e.g., https://your-company.kaiten.ru)
2. API Token: Your personal API token from Kaiten

To get your API token:

1. Log in to your Kaiten instance
2. Go to Settings → API
3. Generate a new token

Dynamic UI Features (New in v0.2.0)

The node now features dynamic select dropdowns that make configuration much easier:

1. Space Selection: Choose from a dropdown of all available spaces
2. Board Selection: After selecting a space, boards are automatically loaded for that space
3. Column Selection: After selecting a board, columns are automatically loaded for that board

This eliminates the need to manually enter names or look up IDs!

Operations

Card Operations

• Get Card: Retrieve a specific card by ID
• Get All Cards from Board: Get all cards from a selected board
• Get All Cards from Column: Get all cards from a specific column

Board Operations

• Get Board: Retrieve a specific board by ID
• Get All Boards: Get all boards from a selected space

Column Operations

• Get All Columns: Get all columns from a selected board

Lane Operations

• Get All Lanes: Get all lanes from a selected board

Space Operations

• Get All Spaces: Retrieve all available spaces

User Operations

• Get Current User: Get information about the current user

Usage Examples

Basic Card Retrieval

1. Select "Card" as resource
2. Select "Get All Cards from Column" as operation
3. Choose your space from the dropdown
4. Choose your board from the auto-populated dropdown
5. Choose your column from the auto-populated dropdown

AI Agent Integration 🤖 (NEW!)

Create intelligent assistants that can answer any questions about your Kaiten board:

What you can ask:

• "How many cards are in the Production column?"
• "What tasks are currently in progress?"
• "Show me project statistics"
• "What is the team working on now?"

Available workflows:

• kaiten-ai-agent-workflow.json - Universal webhook API
• telegram-kaiten-ai-workflow.json - Telegram bot integration

Setup: See examples/AI-AGENT-SETUP.md for detailed instructions.

Telegram Bot Integration

Perfect for creating Telegram bots that can:

• Answer questions about project status using AI
• List cards in specific columns
• Provide intelligent project summaries
• Monitor board activity with natural language queries

Example: User asks "Какие карточки в колонке Производство?" → Bot fetches data → AI analyzes → Smart response sent back.

Example Workflows

The package includes several example workflows:

1. Basic Integration (kaiten-workflow.json)

• Simple card fetching example
• Basic Telegram bot integration
• Error handling and response formatting

2. AI Agent Workflows 🤖 (NEW!)

• kaiten-ai-agent-workflow.json - Universal webhook API for AI questions
• telegram-kaiten-ai-workflow.json - Complete Telegram AI bot
• AI-AGENT-SETUP.md - Detailed setup guide

AI Agent Features:

• Natural language questions about your board
• Intelligent analysis and summaries
• Real-time data from Kaiten
• Supports multiple languages (Russian/English)

To use the examples:

1. Import the workflow file into n8n
2. Configure your Kaiten credentials
3. Set up OpenAI API credentials (for AI features)
4. Configure Telegram bot token (for Telegram integration)
5. Follow the setup guide in examples/AI-AGENT-SETUP.md

Version History

v0.1.2

• FIX: Fixed 404 error when fetching cards - now using correct API endpoints
• FIX: Updated card retrieval to use /api/latest/cards with proper query parameters
• IMPROVEMENT: More efficient column filtering using API parameters instead of client-side filtering

v0.1.1

• Fixed example workflow
• Updated node type references

v0.1.0

• Initial release
• All basic read operations
• Smart selection by name
• Telegram bot support

API Documentation

This node is based on the official Kaiten API documentation: https://developers.kaiten.ru/

Support

For issues and feature requests, please use the GitHub repository issue tracker.

License

MIT