# Agentic Task System (ATS)

An MCP server that exposes tasks from TickTick, Notion, Obsidian or a markdown folder to any MCP client. Your agent can read, create and link items.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: renezander030
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/renezander030/agentic-task-system/tree/HEAD/packages/mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/agentic-task-system-ats

## What it does

It sits on top of a storage adapter. You need `@reneza/ats-mcp` plus one adapter package, `@reneza/ats-adapter-ticktick` if you skip that choice. Adapter lookup runs in order: the `ATS_ADAPTER` variable, then a single line in `~/.config/ats/adapter`, then the ticktick default. Skip the adapter install and the server has nothing to read.

Roughly two dozen tools come with it. `find` runs keyword retrieval and, on embedder-backed adapters, adds dense search with RRF fusion; `explain: true` breaks down each hit. Writes go through `create_task` and `update_task`, while `url_for` returns a link that opens the item in its own app. Another group handles the task tree, lifecycle windows, typed links between items, and scoped access checks that leave an audit trail. A final set snapshots and polls state events.

The security tools are a decision point for a cooperating client. They do not contain tools from other MCP servers. Event tools record state changes only and never execute an agent. The local spool keeps references and hashes rather than task bodies.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ATS_ADAPTER` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agentic-task-system -e ATS_ADAPTER=<ATS_ADAPTER> -- npx -y @reneza/ats-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env ATS_ADAPTER=<ATS_ADAPTER> -- npx -y @reneza/ats-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@reneza/ats-mcp"
            ],
            "env": {
                "ATS_ADAPTER": "<ATS_ADAPTER>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@reneza/ats-mcp"
            ],
            "env": {
                "ATS_ADAPTER": "<ATS_ADAPTER>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ATS_ADAPTER=<ATS_ADAPTER> mcp npx -y @reneza/ats-mcp
```
Replace <…> with your own values

## When to use it
- pull a task from your work app into an agent session
- file a new task in TickTick or Obsidian without leaving the chat
- link two tasks with a typed relation and walk the graph
- grant scoped access to one task and keep a decision log
- follow state changes between agent runs

## Example prompts
- Find everything about the release prep in my tasks and break the results down by source
- Create a task for reviewing item 4 in the `backend` project
- Show incoming and outgoing links for task `T-142`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md