Workstream

io.github.ahmad-codex/workstream-mcp

Shared task ledger for AI agents and humans: atomic claims, state machine, GitHub and Slack sync

View repository →Homepage →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "workstream-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ahmad-codex/workstream-mcp:0.3.1"
      ],
      "env": {
        "WORKSTREAM_DB_CONNECTION": "<your WORKSTREAM_DB_CONNECTION>",
        "WORKSTREAM_ADMIN_TOKEN": "<your WORKSTREAM_ADMIN_TOKEN>",
        "WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
        "WORKSTREAM_USER_TOKEN": "<your WORKSTREAM_USER_TOKEN>"
      }
    }
  }
}
Environment variables
  • WORKSTREAM_DB_CONNECTIONrequiredsecretNpgsql connection string for the PostgreSQL 16 database
  • WORKSTREAM_ADMIN_TOKENrequiredsecretBearer token for the /admin API, used to create users
  • WORKSTREAM_PUBLIC_BASE_URLPublic base URL used when returning user MCP URLs
  • WORKSTREAM_USER_TOKENrequiredsecretYour user token from POST /admin/users. Only used to build the client URL; the server does not read it.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.3.1
Registry
active
Published
10/30/2026

More Developer Tools servers

Browse all Developer Tools →

io.github.ahmaddioxide/image-resolver

ahmaddioxide

MCP server for context-aware royalty-free image search from Pexels and Unsplash

Developer ToolsAdded 8 months ago

ChartPane

ahmadsl

Renders interactive Chart.js charts and dashboards inline in AI conversations.

Developer ToolsAdded 9 months ago

Kachink

ahmadsl

Personal finance tracker — log transactions, view summaries, and browse a dashboard

Developer ToolsAdded 5 months ago

P2Predict

ahmed-khalil-hafsi

Local MCP server for parametric price benchmarking in procurement and engineering.

Developer ToolsAdded 1 month ago

defluff

ahmedak

Deterministic prose linter for LLM text — flags AI slop, filler, buzzwords, hedges, clichés.

Developer ToolsAdded 4 months ago

Al Jazeera 360

ahmedaminsa

Browse, search & watch Al Jazeera 360's Arabic shows, documentaries and podcasts inside the chat.

Developer ToolsAdded 1 month ago

Add the badge to your site

Show visitors that Workstream is listed here — it’s also the link we check for a free listing.

Workstream — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-ahmad-codex-workstream-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Workstream — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Workstream — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ahmad-codex-workstream-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.