taskview-community README

The project's README from github.com/Gimanh/taskview-community. As one markdown file: README.md.

TaskView™

TaskView — Kanban board

Self-hosted project management for software teams.

TaskView combines task management, custom workflows, developer integrations, analytics, and AI-assisted automation in a platform you can run on your own infrastructure.

View more screenshots
Main dashboard (light theme) Main dashboard (dark theme) Main dashboard with collapsed sidebar (light theme) Main dashboard with collapsed sidebar (dark theme) Kanban board (light theme) Kanban board (dark theme) Task list view (light theme) Task list view (dark theme) Recent tasks overview Sprint planning Time tracking Analytics dashboard Organization members management Role permissions (light theme) Role permissions (dark theme) Single Sign-On (SSO) configuration API tokens management Webhooks configuration Integrations UI customization Settings

TaskView Cloud · Documentation · iOS · Android · Releases

Source-Available License Latest release taskview-mcp on npm taskview-api on npm Active development Docker self-hosted

About TaskView

TaskView is a source-available project and task management platform for small and growing software teams.

It is designed for teams that need more structure than a simple task board, but do not want the administration overhead and complexity of large enterprise project management systems.

With TaskView, you can manage projects, build custom workflows, track dependencies and time, connect development tools, and automate project operations through the API, webhooks, and MCP.

Your projects. Your infrastructure. Your data.

Who TaskView is for

TaskView is a good fit for:

Why TaskView

Features

Project and task management

Team collaboration

Identity and access management

Developer integrations

Time tracking and analytics

Applications

AI and MCP integration

TaskView includes an MCP server that allows compatible AI tools to interact with your projects.

Depending on the permissions assigned to an API token, an AI assistant can:

MCP access can be restricted by permission and by selected projects.

Connecting an MCP client

The MCP server is published as taskview-mcp and runs over stdio via npx — no install required. You only need a TaskView API token (tvk_...) — generate one in your account settings (see API tokens). Scope the token to the minimum permissions and projects the assistant should reach.

Claude Code — add to .claude/settings.json (project) or ~/.claude.json (global):

{
  "mcpServers": {
    "taskview": {
      "command": "npx",
      "args": ["-y", "taskview-mcp"],
      "env": {
        "TASKVIEW_URL": "https://api.taskview.tech",
        "TASKVIEW_TOKEN": "tvk_your_token_here"
      }
    }
  }
}

Claude Desktop — add the same mcpServers block to claude_desktop_config.json.

Other MCP clients (Cursor, Windsurf, etc.) — use the same stdio command npx -y taskview-mcp with the TASKVIEW_URL and TASKVIEW_TOKEN environment variables in that client's MCP configuration.

Variable Required Description
TASKVIEW_URL yes TaskView API server URL (e.g. https://api.taskview.tech, or your self-hosted instance)
TASKVIEW_TOKEN yes API token with the tvk_ prefix

See the TaskView MCP documentation and the taskview-mcp package README for the full tool list and more options.

Quick start

Clone the repository:

git clone https://github.com/Gimanh/taskview-community.git
cd taskview-community

The recommended way to run TaskView is with Docker Compose.

For deployment instructions, environment variables, HTTPS configuration, updates, and backups, see the official documentation:

TaskView self-hosting documentation

Production deployments should use persistent volumes, HTTPS, regular database backups, and securely generated secrets.

Repository structure

TaskView is maintained as a monorepo. Product packages share a single version.

taskview-community/
├── api/
│   └── TaskView backend and HTTP API
├── web/
│   └── Vue web application and Capacitor mobile application
├── taskview-packages/
│   ├── taskview-api/
│   │   └── TypeScript API client
│   └── taskview-db-schemas/
│   │   └── Shared Drizzle ORM schemas
│   └── taskview-mcp/
│       └── MCP server for AI integrations
└── build-dockers.sh
    └── Docker image build script

Main packages

Package Description
api Node.js backend and API server
web Vue web client and Capacitor mobile application
taskview-packages/taskview-api TypeScript client for the TaskView API
taskview-packages/taskview-db-schemas Shared Drizzle ORM database schemas
taskview-packages/taskview-mcp MCP server for AI integrations

Technology stack

TaskView is primarily built with:

Local development

These instructions are intended for contributors and local development, not for production deployment.

Prerequisites

You need the following tools:

On macOS, PostgreSQL can be installed using Postgres.app.

Install dependencies

From the repository root:

pnpm install

Configure the API

Create an environment file in the api directory:

cp api/.env.example api/.env

Update api/.env with your local database credentials and application configuration.

Start the web application

cd web
pnpm dev

Start the API

In a separate terminal:

cd api
pnpm start

The API uses Bun in the local development environment.

Building Docker images

Docker image versions are taken from the root package.json.

Build the images

From the repository root:

./build-dockers.sh

Verify the images

docker images

The following images should be available:

gimanhead/taskview-ce-api-server
gimanhead/taskview-ce-webapp
gimanhead/taskview-ce-db-migration

Test the images locally

cd api/dev-containers-test
docker compose up

Ensure that image versions match the version defined in the root package.json.

Versioning

TaskView follows Semantic Versioning:

The version represents the entire TaskView product, not individual packages.

Project status

TaskView is under active development.

New features, database migrations, API changes, and breaking changes may be introduced between releases. Review release notes and back up your database before updating a self-hosted installation.

Roadmap

Planned areas of development include:

The roadmap may change based on product priorities and community feedback.

Contributing

Contributions are welcome.

Before contributing:

  1. Read CONTRIBUTING.md.
  2. Check existing issues and pull requests.
  3. Open an issue before starting a large architectural change.
  4. Follow the project's code style and architecture.
  5. Sign the Contributor License Agreement when required.

Contributions are accepted under the project's CLA.

Licensing

TaskView is distributed under the TaskView Source-Available License.

You may:

You may not:

See LICENSE for the complete terms.

TaskView is source-available, not OSI-approved open-source software.

For commercial licensing questions, hosted service permissions, or other use cases not covered by the license, contact the project maintainer.

Security

Do not publish security vulnerabilities in public GitHub issues.

Report security issues privately — see SECURITY.md for the reporting channels, response times, scope, and safe-harbor terms.

When running TaskView in production:

TaskView is developed and maintained by Nikolai Giman.

TaskView™ and the TaskView logo are trademarks of their respective owner.

Copyright © 2026 Nikolai Giman.

taskview-community (Gimanh/taskview-community)

Searching Database…

1.3K ·GitHub
Taskview-community
Что это?TaskView — самостоятельно размещаемая платформа управления проектами и задачами, сочетающая трекинг задач, настраиваемые workflows, интеграции для разработчиков, аналитику и автоматизацию с помощью ИИ; она создана для команд, которым нужна прозрачная альтернатива SaaS-менеджерам задач.
Это размещённый SaaS-сервис или что-то, что я запускаю на своих серверах?Это ПО, которое вы размещаете у себя на инфраструктуре (через Docker Compose), а не управляемый SaaS. На сайте упоминается отдельное размещённое предложение «TaskView Cloud», но этот репозиторий — для запуска собственного экземпляра.
Как запустить TaskView?Склонируйте репозиторий и запустите через Docker Compose — это рекомендуемый способ развёртывания; документация по self-hosting описывает переменные окружения, HTTPS, обновления и резервные копии.
Что должно быть установлено, чтобы развернуть его или разрабатывать локально?Для продакшена достаточно Docker и Docker Compose. Для локальной разработки монорепозитория также нужны PostgreSQL, Bun и pnpm.
Могу ли я превратить TaskView в собственный hosted-сервис и продавать его?Нет. Лицензия позволяет размещать у себя, изменять и использовать внутри, но нельзя предлагать его как hosted SaaS, продавать доступ к нему или строить на его основе конкурирующий коммерческий продукт.
Можно ли пользоваться TaskView с телефона или только через веб?Помимо self-hosted сервера TaskView поставляет веб-, iOS- и Android-приложения, собранные из того же монорепозитория (мобильные приложения используют Capacitor).
Собирает ли TaskView данные о моих проектах или показывает рекламу?Нет. Рекламы и поведенческого отслеживания нет, поскольку всё работает на инфраструктуре, которую контролируете вы.
Что может ИИ-ассистент через MCP-сервер TaskView?В зависимости от прав API-токена он может искать и просматривать проекты, создавать и обновлять задачи, управлять статусами задач, работать со списками, получать контекст задач и автоматизировать повторяющиеся операции с проектами.
Как подключить TaskView к Claude Code или Cursor?Запустите опубликованный пакет «taskview-mcp» через stdio командой «npx -y taskview-mcp» (установка не нужна) и задайте переменные окружения TASKVIEW_URL и TASKVIEW_TOKEN в MCP-конфиге клиента; токен должен иметь префикс «tvk...» из настроек вашего аккаунта.
Интегрируется ли TaskView с GitHub или GitLab?Да: есть встроенные интеграции с GitHub и GitLab, подписанные вебхуки, публичный HTTP API и TypeScript-клиент API для создания собственных интеграций.
На каком стеке построен TaskView?Фронтенд — Vue/Nuxt с Capacitor для мобильных платформ, бэкенд — Node.js/Express с PostgreSQL и Drizzle ORM; всё упаковано в Docker-образы из монорепозитория.
What are similar projects?rankme.fast, casdoor, planka, Termix, zitadel, wekan, epiq, focalboard
Which topics is it in?kanban-board, scim, time-tracker, nuxtjs, task-manager, task, saml, drizzle-orm, project-management, oidc, task-management, ios-app
Creator
Gimanh
Size
28.3 MB
Stars
1.3K
Updated
CommitOct 14Releasev1.56.0Sep 22
Age
9mo
Commits · 90 Days