Gimanh/taskview-community

TaskView™

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

TaskView Cloud · Documentation · iOS · Android · Releases

---

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:

• software development teams;
• startups and small product companies;
• agencies managing internal and client projects;
• organizations that require self-hosting and data ownership;
• teams looking for a lightweight alternative to complex enterprise platforms;
• developers using AI agents to manage and automate project work;
• individuals managing technical or personal projects.

Why TaskView

• Own your data - run TaskView on your own infrastructure.
• Flexible workflows - configure projects, statuses, boards, roles, and permissions.
• Built for development teams - connect GitHub, GitLab, API clients, and webhooks.
• AI-ready - allow MCP-compatible assistants to work with tasks and projects.
• Available everywhere - use TaskView from the web, iOS, and Android.
• No advertising or behavioral tracking - your project data remains under your control.

Features

Project and task management

• Projects, lists, tasks, and nested subtasks
• Custom Kanban boards and task statuses
• Priorities, tags, deadlines, and assignees
• Task dependency graph
• Sprints and recurring tasks
• Task history and activity tracking
• Markdown content
• Search and filtering
• Reusable project workflows

Team collaboration

• Multiple organizations and projects
• User invites and granular permissions
• Clear responsibility assignment
• Real-time updates
• Notifications
• Organization-level user management

Identity and access management

• SAML 2.0
• OpenID Connect
• SCIM provisioning
• Scoped API tokens
• Project-level access restrictions
• Fine-grained token permissions

Developer integrations

• GitHub integration
• GitLab integration
• Signed webhooks
• TypeScript API client
• Public HTTP API
• MCP server for AI assistants

Time tracking and analytics

• Built-in time tracking
• Billable and non-billable time
• Project and team workload reports
• Productivity analytics
• Income and expense tracking
• Financial reports

Applications

• Web application
• iOS application
• Android application
• Self-hosted server deployment

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:

• search and inspect projects;
• create and update tasks;
• manage task statuses;
• work with project lists;
• retrieve task context;
• automate repetitive project operations.

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:

• Vue
• Nuxt UI
• TypeScript
• Node.js
• Express
• PostgreSQL
• Drizzle ORM
• Capacitor
• Docker

Local development

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

Prerequisites

You need the following tools:

• Docker
• PostgreSQL
• Bun
• pnpm

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:

• MAJOR - breaking API, database, or compatibility changes;
• MINOR - backward-compatible features;
• PATCH - backward-compatible bug fixes.

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:

• [ ] Desktop application
• [ ] Plugin and extension system
• [ ] Additional third-party integrations
• [ ] Expanded automation capabilities
• [ ] Continued UI and UX improvements

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:

• self-host TaskView;
• modify the source code;
• use TaskView internally within your organization;
• create integrations and internal extensions.

You may not:

• offer TaskView as a hosted SaaS;
• sell access to TaskView as a service;
• create a competing commercial product based on TaskView;
• use the TaskView name, logo, or branding for derivative products.

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:

• use HTTPS;
• generate unique application secrets;
• restrict database access;
• keep Docker images and dependencies updated;
• configure persistent storage;
• create regular backups;
• restrict API-token permissions to the minimum required scope.

Links

• TaskView website
• TaskView Cloud
• Documentation
• iOS application
• Android application
• GitHub repository

---

TaskView is developed and maintained by Nikolai Giman.

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

Copyright © 2026 Nikolai Giman.