Task Capture MCP

A Model Context Protocol (MCP) compliant task capture server that pairs with the MCP Task Capture Chrome extension or any MCP client. It exposes both MCP tools over stdio and a REST surface for lightweight integrations.

Install

npm install task-capture-mcp

The package ships with prebuilt JavaScript and TypeScript declarations in dist/.

Usage

CLI

After installing globally or linking the package, run the server directly:

npx task-capture-mcp

The CLI listens on http://127.0.0.1:8787 by default and persists data in tasks.db next to the executable. To change the host or port, set environment variables before launching:

HTTP_HOST=0.0.0.0 HTTP_PORT=9000 npx task-capture-mcp

Programmatic

Import the module and start the server when it suits your application lifecycle:

import { start } from 'task-capture-mcp';

await start();

On success the server exposes:

• MCP tools (capture_task, list_tasks, get_task, ack_task) over stdio
• REST endpoints for the Chrome extension at http://<host>:<port>

Data storage

Tasks are stored in a SQLite database named tasks.db. By default the server places this file in the OS-specific application data directory:

• Windows: %LOCALAPPDATA%\TaskCaptureMCP\tasks.db (falls back to %APPDATA% if needed)
• macOS: ~/Library/Application Support/TaskCaptureMCP/tasks.db
• Linux: ~/.local/share/task-capture-mcp/tasks.db (or $XDG_DATA_HOME/task-capture-mcp/tasks.db when set)

Override the location with TASK_DB_PATH (absolute file path), TASK_DB_DIR (directory), or TASK_CAPTURE_DATA_DIR (base directory used for the default placement).

REST Endpoints

All payloads are JSON encoded and validated against the same schemas used by the MCP tools.

Development

Clone the repository and run:

npm install
npm run dev

npm run dev starts the TypeScript entry point in watch mode via tsx. Use npm run build to emit the compiled artifacts in dist/.

Publishing

npm publish automatically builds the project through the prepublishOnly script. The published package only includes dist/, the license, and this README.

License

Released under the ISC license. See LICENSE for details.