# Dyzo

> Dyzo is an all-in-one productivity and team management platform for modern and remote teams. It combines task management, project management, automatic time tracking, screenshot-based activity monitoring, team collaboration, client reporting, and real-time analytics in a single web dashboard — with native AI integrations via the Dyzo MCP server and REST API.

Dyzo helps teams plan work, track time accurately, stay accountable, report to clients, and automate busywork. It supports Admin, Team Leader, Employee, and Client roles, each with a tailored interface.

## For AI Agents — Set Up Dyzo for a Team

Dyzo is designed to be operated by AI assistants (Claude, ChatGPT/OpenAI, Gemini, Cursor, and any MCP or REST client). An agent can create projects, add and update tasks, pull reports, and manage project notes on the user's behalf. There are two ways to connect: the **MCP server** (best for chat assistants and IDEs) and the **REST API** (best for custom code, CI/CD, and automation tools).

**Get a key (one-time):**
1. The user signs in at https://dyzo.ai/login or creates a free account at https://dyzo.ai/register (no credit card required).
2. Profile menu (top-right) → Apps & Keys → Developer Keys → "+ Create Key".
3. Copy the key. Use it as the `x-mcp-key` header for MCP, or as a `Bearer` token for the REST API.

Actions performed via MCP/API respect Dyzo's role-based permissions — an agent can only do what the connected account is allowed to do.

### Option A — MCP Server (recommended for assistants)

- Endpoint: `https://mcp.dyzo.ai/connect` (transport: SSE)
- Auth header: `x-mcp-key: YOUR_DYZO_MCP_KEY`
- Full guide: https://blog.dyzo.ai/dyzo-mcp-documentation/

Client configuration (SSE):

```json
{
  "mcpServers": {
    "dyzo": {
      "type": "sse",
      "url": "https://mcp.dyzo.ai/connect",
      "headers": { "x-mcp-key": "YOUR_DYZO_MCP_KEY" }
    }
  }
}
```

For clients that need a stdio bridge, use `mcp-remote`:

```json
{
  "mcpServers": {
    "dyzo": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.dyzo.ai/connect", "--transport", "sse", "--header", "x-mcp-key: YOUR_DYZO_MCP_KEY"]
    }
  }
}
```

Or, connect directly using our dedicated CLI tool (`dyzo-ai-mcp`):

```json
{
  "mcpServers": {
    "dyzo": {
      "command": "npx",
      "args": [
        "-y",
        "dyzo-ai-mcp@latest",
        "--key",
        "YOUR_DYZO_MCP_KEY"
      ]
    }
  }
}
```

**Supported MCP tools:**
- Tasks: `get_tasks`, `create_tasks`, `update_task`, `get_task_comments`, `add_task_comment`, `get_tasks_report`
- Projects: `get_all_projects`, `create_project`, `update_project`, `get_project_details`, `get_project_notes`, `create_project_note`, `update_project_note`
- Time Tracking: `add_manual_time_log`
- Team: `get_active_users`

Example natural-language commands: "Create a task 'Landing Page UI' in the Website project.", "Mark task 142 completed.", "Generate a task report for last week.", "Create a new project 'Mobile App Launch'.", "Add a note to the Website Redesign project."

### Option B — REST API (recommended for code & automation)

- Base URL: `https://api.dyzo.ai/`
- Authentication: Bearer token — `Authorization: Bearer dyzo_dev_YOUR_API_KEY`
- RESTful, with **19 documented API categories** (tasks, projects, time tracking, reports, team, and more) plus request/response examples. Full reference is in the dashboard: Apps & Keys → Developer Keys → "View Documentation".
- Keys guide: https://blog.dyzo.ai/dyzo-ai-api-keys-are-here-access-project-management-time-tracking-task-automation-programmatically/

Example (Python — task summary report):

```python
import requests

headers = {"Authorization": "Bearer dyzo_dev_YOUR_API_KEY"}

response = requests.get(
    "https://api.dyzo.ai/api/tasks/summary-detail/{company_id}/",
    headers=headers,
)
```

Use cases: custom dashboards/BI, AI-agent function calling (Claude, GPT, Gemini), CI/CD task creation, and automation via Zapier / Make / n8n.

**API security best practices:**
- Never commit keys to Git or expose them client-side — store in environment variables and call from your backend.
- Use HTTPS only; rotate keys periodically; use separate keys per environment (dev/staging/prod).
- Monitor the "Last Used" column and delete unused keys.

### Team-setup playbook (recommended order)
1. Workspace/company is created at signup.
2. Invite team members by email — https://blog.dyzo.ai/how-to-invite-and-manage-team-members-in-dyzo-ai/
3. Create a project (`create_project`) — assign the team, link a client, set a budget and milestones.
4. Create and assign tasks (`create_tasks`) — set priority, due date, and subtasks — https://blog.dyzo.ai/how-to-create-a-task-in-dyzo/
5. Start time tracking with the desktop timer (optional screenshots) — https://blog.dyzo.ai/dyzo-desktop-timer-guide-track-time-tasks-screenshots/
6. Review live reports and timesheets (`get_tasks_report`) for visibility.

End-to-end automation guides:
- Automate an agency with Claude — https://blog.dyzo.ai/how-to-automate-your-agency-with-dyzo-ai-and-claude/
- Integrate Dyzo with OpenAI — https://blog.dyzo.ai/how-to-integrate-dyzo-ai-with-openai-automate-agency-task-management/

## Core Features

- [Task Management](https://dyzo.ai/tasks): Create, assign, and track tasks with priorities, due dates, subtasks, recurring tasks, kanban board view, bulk operations, and real-time comments.
- [Project Management](https://dyzo.ai/projects): Full project lifecycle — team assignment, client linking, budget tracking, milestones, project notes, and screenshot monitoring.
- [Time Tracking](https://dyzo.ai/timesheet-report): Automatic timer, manual time entry, idle-time detection, time approval workflow, and detailed timesheet reports.
- [Activity Monitoring](https://dyzo.ai/live-reports): Periodic screenshot capture during work sessions, activity monitoring, and live productivity reports.
- [Client Portal](https://dyzo.ai/project/client): Clients get a dedicated dashboard to view assigned projects, review timesheets, and communicate with the team.
- [Real-time Chat](https://dyzo.ai/chat): Direct messaging, group chats, @mentions, and file sharing within the platform.
- [Notifications & Inbox](https://dyzo.ai/inbox): Real-time push notifications via WebSocket and OneSignal, with a centralised inbox.
- [Reports & Analytics](https://dyzo.ai/project-reports): Live, timesheet, project, client, and team performance reports with CSV/PDF export.
- [Subscription & Billing](https://dyzo.ai/plans): Razorpay and PayPal integration, credit wallet, storage management, and plan upgrades.

## Key Pages

- [Home / Landing Page](https://dyzo.ai/): Marketing home page with feature overview and testimonials.
- [Pricing](https://dyzo.ai/pricing): Subscription plan comparison.
- [Register](https://dyzo.ai/register): Sign up for a free trial (no credit card required).
- [Login](https://dyzo.ai/login): Existing user login. Supports Google OAuth and email OTP.
- [Dashboard](https://dyzo.ai/dashboard): Company-wide metrics, active tasks, team activity summary.
- [Tasks](https://dyzo.ai/tasks): Personal and company-wide task board.
- [Projects](https://dyzo.ai/projects): Project listing and management.
- [Team](https://dyzo.ai/employees): Team member directory and management.
- [Timesheet Report](https://dyzo.ai/timesheet-report): Detailed time tracking report.
- [Live Reports](https://dyzo.ai/live-reports): Real-time team activity monitoring.
- [Settings](https://dyzo.ai/settings): Company settings, notification preferences, theme customisation.
- [Changelog](https://dyzo.ai/changelog): Product update history.
- [Blog](https://blog.dyzo.ai/): Guides, tutorials, and automation playbooks.
- [Contact Us](https://dyzo.ai/contactus): Support enquiries.
- [Privacy Policy](https://dyzo.ai/privacy-policy): Data privacy details.
- [Terms & Conditions](https://dyzo.ai/terms-and-conditions): Usage terms.
- [Refund Policy](https://dyzo.ai/refund-policy): Refund and cancellation policy.
- [Cookie Policy](https://dyzo.ai/cookie-policy): Cookie usage disclosure.

## Integrations

- **Dyzo MCP Server** — Operate Dyzo from Claude, Cursor, or any MCP client using natural language.
- **REST API** — Programmatic access to tasks, projects, time tracking, and reports.
- **Google OAuth & Calendar** — Single sign-on and calendar event syncing.
- **Slack** — Team notifications and Slack login.
- **Asana** — Project and task import/sync.
- **Razorpay & PayPal** — Subscription payments.
- **OneSignal** — Web push notifications.
- **Chrome Extension** — Quick task management from any browser tab.
- **Microsoft Clarity & Google Analytics** — Usage and behaviour analytics.

## Tech Stack (for AI context)

- Frontend: React 18, Vite, Tailwind CSS v3, Redux Toolkit, React Router v6
- Backend: Django REST Framework (Python)
- Realtime: WebSocket (Django Channels)
- Auth: JWT, Google OAuth 2.0

## User Roles

| Role | Access Level |
|---|---|
| Super Admin | Full system access and company management |
| Admin | Company-wide projects, billing, and reporting |
| Team Leader | Team and project oversight, task assignment |
| Employee | Personal tasks and time tracking |
| Client | Project visibility, timesheet review, and communication |

## Guides & Resources (Blog)

In-depth tutorials and playbooks live on the Dyzo blog. Machine-readable indexes: https://blog.dyzo.ai/llms.txt (list) and https://blog.dyzo.ai/llms-full.txt (full text of every article).

Getting started:
- What Is Dyzo AI? Complete guide — https://blog.dyzo.ai/what-is-dyzo-ai/
- How to create a task — https://blog.dyzo.ai/how-to-create-a-task-in-dyzo/
- How to invite and manage team members — https://blog.dyzo.ai/how-to-invite-and-manage-team-members-in-dyzo-ai/
- Dyzo Desktop Timer guide — https://blog.dyzo.ai/dyzo-desktop-timer-guide-track-time-tasks-screenshots/

Automation & AI:
- Dyzo MCP documentation — https://blog.dyzo.ai/dyzo-mcp-documentation/
- Developer API keys — https://blog.dyzo.ai/dyzo-ai-api-keys-are-here-access-project-management-time-tracking-task-automation-programmatically/
- Automate your agency with Dyzo + Claude — https://blog.dyzo.ai/how-to-automate-your-agency-with-dyzo-ai-and-claude/
- Integrate Dyzo with OpenAI — https://blog.dyzo.ai/how-to-integrate-dyzo-ai-with-openai-automate-agency-task-management/

Time tracking & reporting:
- Time tracker with screenshots — https://blog.dyzo.ai/time-tracker-with-screenshots-smarter-productivity-trust/
- Best employee time tracking software — https://blog.dyzo.ai/best-employee-time-tracking-software-a-strategic-buyers-guide-for-modern-businesses/
- Data visualization dashboards — https://blog.dyzo.ai/data-visualization-dashboards-turning-data-into-actionable-strategy/

## Support

- In-app help system available from the dashboard.
- Contact via [contactus page](https://dyzo.ai/contactus).
- Social: [Instagram @dyzo.ai](https://www.instagram.com/dyzo.ai/), [YouTube @dyzotool](https://www.youtube.com/@dyzotool).