memtask 0.0.2

A local MCP server for durable agent task state and lightweight memory.

MemTask

MemTask gives MCP agents a local task list and lightweight memory, backed by SQLite.

Install

pip install MemTask

Start

memtask start

MemTask starts a local MCP server at:

http://127.0.0.1:8000/mcp

Add It To Codex

memtask install

That prints the exact codex mcp add ... commands for stdio and HTTP:

Codex

stdio server
  codex mcp add memtask -- memtask start --transport stdio

HTTP server
  memtask start
  codex mcp add memtask --url http://127.0.0.1:8000/mcp

Use It

Once connected, your agent gets tools for:

• tasks: add, list, focus, complete, remove, and track dependencies
• memory: remember, recall, update, and delete scoped context

Common Commands

memtask status
memtask stop
memtask start --transport stdio

What It Is

MemTask is a local MCP server for developer-built agents that need durable task state and persistent context. It gives an agent a small workspace for tracking active work, dependency order, completed tasks, and scoped memories across sessions.

State is stored locally. In this repo, MemTask uses data/tasks.sqlite. When installed outside this repo, it uses ~/.memtask/tasks.sqlite by default. Set MEMTASK_DB_PATH to choose a specific SQLite path.

Development

Run tests:

python -m pytest

Compile-check the package:

python -m py_compile src/memtask/*.py tests/*.py