Metadata-Version: 2.4
Name: 1wlf-tms-mcp
Version: 0.1.2
Summary: MCP server for the 1WLF Task Management System
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# 1WLF TMS — MCP Server

Connect AI assistants to the [1WLF Task Management System](https://tms.1wlf.com). Manage organizations, projects, and tasks through natural language via [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Claude Desktop, or any [MCP](https://modelcontextprotocol.io)-compatible client.

## Quick Start

### Claude Code

```bash
claude mcp add tms -- uvx 1wlf-tms-mcp
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tms": {
      "command": "uvx",
      "args": ["1wlf-tms-mcp"]
    }
  }
}
```

> Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) to be installed. `uvx` handles downloading and running the server automatically — no manual Python setup needed.

### pip

```bash
pip install 1wlf-tms-mcp
tms-mcp  # runs the stdio server
```

## Usage

Start a session and authenticate first:

> *"Log into TMS as user@example.com"*

Then interact naturally:

> *"What organizations do I belong to?"*
>
> *"List all blocked tasks in project 5"*
>
> *"Create a high-priority bug 'Fix login redirect' in project 3"*
>
> *"Show me task 42 with its audit history"*
>
> *"Move task 42 to done and assign task 15 to user 7"*

## Tools

| Tool | Description |
|---|---|
| `tms_login` | Authenticate with email and password (required first) |
| `tms_whoami` | Get current user info |
| `tms_list_organizations` | List your organizations with optional task stats |
| `tms_list_projects` | List projects, filter by organization |
| `tms_get_project` | Project details and members |
| `tms_list_tasks` | List and filter tasks by status, priority, assignee |
| `tms_get_task` | Task details, subtasks, and audit log |
| `tms_create_task` | Create tasks and subtasks |
| `tms_update_task` | Update any task field |
| `tms_delete_task` | Delete a task and its subtasks |
| `tms_search_users` | Find users by name or email |

## Task Fields

| Field | Values |
|---|---|
| Status | `backlog` · `todo` · `in-progress` · `blocked` · `testing` · `in-review` · `done` |
| Priority | `low` · `medium` · `high` · `critical` |
| Type | `task` · `story` · `feature` |
| Category | `feature` · `bug` · `improvement` · `maintenance` |
| Difficulty | `1` to `5` |

## Self-Hosted

Override the API URL for your own TMS instance:

```json
{
  "mcpServers": {
    "tms": {
      "command": "uvx",
      "args": ["1wlf-tms-mcp"],
      "env": {
        "TMS_API_URL": "https://your-tms-api.example.com"
      }
    }
  }
}
```

## Requirements

- Python 3.10+
- A [1WLF TMS](https://tms.1wlf.com) account

## Links

- [TMS Web App](https://tms.1wlf.com)
- [MCP Protocol](https://modelcontextprotocol.io)
