# Thask MCP server

> Provides a dependency-graph layer that lets AI agents query project relationships and impact analysis to prevent breaking downstream flows.

- Repository: https://github.com/kimgh06/Thask
- Page: https://hostedmcp.org/servers/kimgh06/thask
- Transport: stdio
- Stars: 8
- License: MIT
- Latest version: 0.6.0

## Install

### Claude Code

```sh
claude mcp add --env 'THASK_TOKEN=<YOUR_THASK_TOKEN>' --env 'THASK_URL=<THASK_URL>' thask -- npx -y @thask-org/cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "thask": {
      "command": "npx",
      "args": [
        "-y",
        "@thask-org/cli"
      ],
      "env": {
        "THASK_TOKEN": "<YOUR_THASK_TOKEN>",
        "THASK_URL": "<THASK_URL>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "thask": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thask-org/cli"
      ],
      "env": {
        "THASK_TOKEN": "<YOUR_THASK_TOKEN>",
        "THASK_URL": "<THASK_URL>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"thask","type":"stdio","command":"npx","args":["-y","@thask-org/cli"],"env":{"THASK_TOKEN":"<YOUR_THASK_TOKEN>","THASK_URL":"<THASK_URL>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "thask": {
      "command": "npx",
      "args": [
        "-y",
        "@thask-org/cli"
      ],
      "env": {
        "THASK_TOKEN": "<YOUR_THASK_TOKEN>",
        "THASK_URL": "<THASK_URL>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add thask --env 'THASK_TOKEN=<YOUR_THASK_TOKEN>' --env 'THASK_URL=<THASK_URL>' -- npx -y @thask-org/cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.thask]
command = "npx"
args = ["-y", "@thask-org/cli"]

[mcp_servers.thask.env]
THASK_TOKEN = "<YOUR_THASK_TOKEN>"
THASK_URL = "<THASK_URL>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'THASK_TOKEN=<YOUR_THASK_TOKEN>' -e 'THASK_URL=<THASK_URL>' thask npx -- -y @thask-org/cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "thask": {
      "command": "npx",
      "args": [
        "-y",
        "@thask-org/cli"
      ],
      "env": {
        "THASK_TOKEN": "<YOUR_THASK_TOKEN>",
        "THASK_URL": "<THASK_URL>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `THASK_TOKEN` | yes | yes | API key for your Thask account. Generate via `thask login` (browser flow, recommended) or in the web UI settings. |
| `THASK_URL` | yes | no | URL of your Thask server (e.g. https://thask.kimgh06.com or http://localhost:7244). Can also be set via `thask config set url <url>`. |
| `APP_URL` | no | no |  |
| `SESSION_SECRET` | no | no |  |

## FAQ

### How does Thask prevent AI agents from hallucinating project descriptions?

Agent keys default to blocking semantic writes, meaning they propose changes to a suggestion queue for human approval rather than writing directly to the source of record.

### Can I use Thask to scan my Go codebases?

Yes, the Go Dependency Scanner can parse go.mod and imports to automatically generate dependency graphs.
