Skip to main content
Glama

Arc Todo MCP

Python FastAPI MCP server for Arc Todo. Exposes Streamable HTTP MCP at /mcp and wraps the existing Arc Todo REST API for tasks, knowledge, and workspace context.

Prerequisites

Related MCP server: mcp-task-manager

Setup

cd arc-todo-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env

Environment variables

Variable

Default

Purpose

PORT

8000

HTTP port

ARC_TODO_API_BASE_URL

http://localhost:3000

Arc Todo API base URL

ARC_TODO_USERNAME

Service account username

ARC_TODO_PASSWORD

Service account password

ARC_TODO_ACCESS_TOKEN

Optional pre-issued bearer token

MCP_TOOL_SETTINGS_REFRESH_ON_START

true

Load enabled tools from API on startup

RAG_API_BASE_URL

http://localhost:8020

Arc Todo RAG service base URL

RAG_TIMEOUT_SECONDS

30

RAG HTTP request timeout

RAG_TOP_K

5

Default max chunks when not specified in tool call

RAG_MAX_CONTEXT_TOKENS

4000

Default context token budget when not specified

Run locally

uvicorn app.main:app --reload --port 8000

Endpoints:

  • GET /health{ "status": "ok" }

  • POST /mcp → Streamable HTTP MCP transport

Configure enabled tools in the web app at /settings/mcp-tools, then restart this service so MCP discovery reflects the saved settings.

Tests

pytest

Deployment

See coolify.md.

Related MCP Connectors

Related MCP Servers