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
What is this?TaskView is a self-hosted project and task management platform that combines task tracking, custom workflows, developer integrations, analytics, and AI-assisted automation, built for teams that want a transparent alternative to SaaS task managers.
Is this a hosted SaaS service or something I run on my own servers?It's software you self-host on your own infrastructure (via Docker Compose), not a managed SaaS. A separate 'TaskView Cloud' hosted offering is mentioned on the website, but this repository is for running your own instance.
How do I get TaskView running?Clone the repository and run it with Docker Compose, which is the recommended deployment method; the self-hosting docs cover environment variables, HTTPS, updates, and backups.
What do I need installed to set it up or develop it locally?For production you just need Docker and Docker Compose. For local development of the monorepo you also need PostgreSQL, Bun, and pnpm.
Can I turn TaskView into my own hosted service and sell it?No. The license lets you self-host, modify, and use it internally, but you can't offer it as a hosted SaaS, sell access to it, or build a competing commercial product from it.
Can I use TaskView from my phone, or only on the web?TaskView ships web, iOS, and Android applications built from the same monorepo (the mobile apps use Capacitor), in addition to the self-hosted server.
Does TaskView track my project data or show ads?No. There's no advertising or behavioral tracking, since everything runs on infrastructure you control.
What can an AI assistant do through TaskView's MCP server?Depending on the API token permissions, it can search and inspect projects, create and update tasks, manage task statuses, work with lists, retrieve task context, and automate repetitive project operations.
How do I connect TaskView to Claude Code or Cursor?Run the published 'taskview-mcp' package over stdio with 'npx -y taskview-mcp' (no install needed) and set the TASKVIEW_URL and TASKVIEW_TOKEN environment variables in the client's MCP config; the token needs the 'tvk...' prefix from your account settings.
Does TaskView integrate with GitHub or GitLab?Yes, it has built-in GitHub and GitLab integrations, signed webhooks, a public HTTP API, and a TypeScript API client for building custom developer integrations.
What's the tech stack behind TaskView?The frontend is Vue/Nuxt with Capacitor for mobile, and the backend is Node.js/Express with PostgreSQL and Drizzle ORM, all packaged as Docker images from a monorepo.
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