How to Get Support for Kaneo: 7 Official Channels and Community Resources

Kaneo offers official support through Discord, GitHub Issues, documentation, and a built-in MCP endpoint for programmatic assistance.

The open-source project management platform provides multiple pathways for users to resolve issues, report bugs, and engage with the core team. Whether you're running a self-hosted instance or contributing code, understanding how to get support for Kaneo efficiently will save time and connect you with the right resources.

Official Documentation and Self-Service Resources

The fastest way to resolve common issues is through Kaneo's comprehensive documentation and repository files.

Primary Documentation Site

Browse the official docs at https://kaneo.app/docs/core for in-depth guides covering:

  • Installation and configuration
  • API usage patterns
  • Troubleshooting common deployment issues

This link appears prominently in the repository's [README.md](https://github.com/usekaneo/kaneo/blob/main/README.md), making it the first stop for new users.

Repository Reference Files

Several markdown files in the usekaneo/kaneo repository provide structured guidance:

File Purpose
[README.md](https://github.com/usekaneo/kaneo/blob/main/README.md) Project overview, quick-start guide, and community links
[CONTRIBUTING.md](https://github.com/usekaneo/kaneo/blob/main/CONTRIBUTING.md) Guidelines for filing issues and pull requests
[ENVIRONMENT_SETUP.md](https://github.com/usekaneo/kaneo/blob/main/ENVIRONMENT_SETUP.md) Detailed setup and CORS troubleshooting
[CLAUDE.md](https://github.com/usekaneo/kaneo/blob/main/CLAUDE.md) Monorepo architecture (API, web, docs structure)
[charts/kaneo/README.md](https://github.com/usekaneo/kaneo/blob/main/charts/kaneo/README.md) Helm chart instructions for Kubernetes deployments

Real-Time Community Support via Discord

For immediate assistance, join the Kaneo Discord server at https://discord.gg/rU4tSyhXXU. This invite link is located at line 12 of the README.

What you'll find in the Discord community:

  • Real-time chat with the core development team
  • Quick answers from experienced users
  • Community-driven tips for self-hosted deployments
  • Announcements about new releases and features

Discord is particularly valuable for self-hosted users who need environment-specific troubleshooting that may not be covered in generic documentation.

Structured Issue Tracking on GitHub

When you encounter reproducible bugs or have feature requests, use GitHub's structured workflows.

GitHub Issues

Open a new issue at https://github.com/usekaneo/kaneo/issues — this link appears at line 54 of the README.

Issues are tracked, searchable, and linked to code changes. Use this channel for:

  • Bug reports with reproduction steps
  • Feature requests with clear use cases
  • Performance problems with metrics

GitHub Discussions

For open-ended questions and ideas that don't fit the issue workflow, use the Discussions tab at https://github.com/usekaneo/kaneo/discussions. This is ideal for:

  • Architecture questions
  • Community polls
  • Sharing custom configurations

Programmatic Support via Model Context Protocol (MCP)

Kaneo uniquely provides built-in AI-assisted support through its MCP endpoint at /api/mcp. This enables programmatic interaction with your instance for automation and diagnostics.

Using the Official MCP Client

Install and use the @kaneo/mcp package to interact with your Kaneo instance programmatically:

// Install the client: npm install -g @kaneo/mcp
import { createMCPClient } from "@kaneo/mcp";

const client = createMCPClient({
  baseUrl: process.env.KANEO_API_URL ?? "http://localhost:1337",
  apiKey: process.env.KANEO_API_KEY, // optional for non-interactive auth
});

async function listTasks() {
  const tasks = await client.tasks.list();
  console.log("Tasks:", tasks);
}

listTasks().catch(console.error);

The client automatically connects to the /api/mcp endpoint, providing programmatic access to tasks, projects, and labels. This can be leveraged for:

  • Building custom support bots
  • Automated diagnostics scripts
  • Integration with AI assistants (Claude, Cursor)

Details are documented in the [packages/mcp/README.md](https://github.com/usekaneo/kaneo/blob/main/packages/mcp/README.md) and MCP documentation at https://docs.kaneo.app/core/integrations/mcp.

Automated Issue Creation from the Command Line

For streamlined bug reporting, use the GitHub CLI to create issues directly from your terminal:


# Install the GitHub CLI

brew install gh   # macOS

# Or: https://github.com/cli/cli for other platforms

# Authenticate

gh auth login

# Create a new issue

gh issue create \
  --repo usekaneo/kaneo \
  --title "Unexpected 500 error when creating a task" \
  --body "Steps to reproduce:\n1. Log in\n2. Create a new task...\nEnvironment: Docker Compose, PostgreSQL 16"

This approach is especially useful for operators managing multiple self-hosted instances who want to standardize their reporting workflow.

Direct Financial Support and Sponsorship

To directly support Kaneo development and gain visibility within the community, sponsor the project on GitHub at https://github.com/sponsors/andrejsshell. This link appears at line 51 of the README.

Sponsors receive:

  • Recognition on the project website
  • Direct access to maintainers for critical issues
  • Priority consideration for feature requests

Architectural Considerations for Self-Hosted Support

Understanding Kaneo's architecture helps you determine the right support channel:

  • Self-hosted by default: Kaneo runs as Docker containers (API, web UI, PostgreSQL) that you control. Most operational issues are environment-specific and best addressed through Discord or documentation.

  • MIT License: The permissive license allows you to fork, modify, and deploy private instances. You can create internal support channels if needed.

  • Monorepo structure: Source code is organized across apps/api, apps/web, and packages/ directories as documented in [CLAUDE.md](https://github.com/usekaneo/kaneo/blob/main/CLAUDE.md). This structure helps you locate relevant code when debugging.

Summary

  • Fastest answers: Check https://kaneo.app/docs/core and repository markdown files first
  • Real-time help: Join Discord at https://discord.gg/rU4tSyhXXU
  • Bug reports: Use GitHub Issues at https://github.com/usekaneo/kaneo/issues
  • Open discussion: Post in GitHub Discussions for architecture questions
  • Programmatic access: Leverage the /api/mcp endpoint with @kaneo/mcp
  • Kubernetes deployments: Consult charts/kaneo/README.md for Helm-specific guidance
  • No public email: Critical issues should be tagged in GitHub Issues for maintainer attention

Frequently Asked Questions

What is the fastest way to get help with a Kaneo installation?

Check the official documentation at https://kaneo.app/docs/core first, then join the Discord server for real-time assistance. Most common setup issues are covered in [ENVIRONMENT_SETUP.md](https://github.com/usekaneo/kaneo/blob/main/ENVIRONMENT_SETUP.md), particularly CORS configuration and environment variable problems.

Does Kaneo offer paid commercial support?

There is no formal commercial support tier. The project is MIT-licensed and community-driven. However, GitHub sponsors at https://github.com/sponsors/andrejsshell receive recognition and prioritized attention for critical issues. Organizations requiring dedicated support can fork the repository and maintain private patches under the license terms.

How do I report a security vulnerability in Kaneo?

The repository does not expose a public security email to avoid spam. Open a GitHub issue and tag the maintainers directly, or use GitHub's private vulnerability reporting feature if available. For self-hosted instances, you control the infrastructure and can apply patches immediately from the source without waiting for an official release.

Can I use AI tools to help manage my Kaneo instance?

Yes. Every Kaneo instance ships with an MCP endpoint at /api/mcp. Install the @kaneo/mcp package to enable Claude, Cursor, or other MCP-compatible clients to read tasks, update projects, and automate workflows. This provides AI-assisted operational support without requiring external API integrations.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →