@memnox/mcp

Memnox MCP server — organizational memory and context intelligence for AI coding tools and CI/CD pipelines.

Memnox connects to your Slack, GitHub, Jira, Linear, and meeting recordings and makes that context available inside any AI coding tool through the Model Context Protocol (38 tools total).

Quick Start

AI Coding Tools (Claude Code, Cursor, Windsurf, Zed)

Run the setup wizard. It detects your installed tools and writes the config automatically:

npm install -g @memnox/mcp
memnox setup

Get your token at https://memnox.com → Profile → Personal Access Token

That's it. Restart your IDE.

Manual Configuration

If you prefer to configure manually, install the package globally first, then find the binary path:

npm install -g @memnox/mcp
which memnox   # copy this path

Then add this to your MCP config file (replace /path/to/memnox with the output of which memnox):

{
  "mcpServers": {
    "memnox": {
      "command": "/path/to/memnox",
      "args": ["serve"],
      "env": {
        "MEMNOX_PAT": "your-token-here",
        "MEMNOX_API_URL": "https://api.memnox.com"
      }
    }
  }
}

| Tool | Config file location | |---|---| | Claude Code | ~/.claude/settings.json | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_settings.json | | Zed | ~/.config/zed/settings.json |

CI/CD Integration

GitHub Actions — Deployment Gate

Blocks deployment when Memnox detects open critical tasks or unresolved violations.

Add to your repository:

• MEMNOX_PAT in Settings → Secrets → Actions
• MEMNOX_PROJECT_ID in Settings → Variables → Actions

Then copy ci/github-deployment-gate.yml from this package to .github/workflows/:

npx -y @memnox/mcp ci \
  --check deployment-readiness \
  --project "$MEMNOX_PROJECT_ID" \
  --token "$MEMNOX_PAT"

GitHub Actions — PR Review

Posts a Memnox review comment on every PR with decision conflicts and pattern concerns.

Copy ci/github-pr-review.yml to .github/workflows/:

npx -y @memnox/mcp ci \
  --check pr-review \
  --project "$MEMNOX_PROJECT_ID" \
  --token "$MEMNOX_PAT" \
  --pr-title "Your PR title" \
  --fail-on blocked

GitLab CI

Copy ci/gitlab-ci.yml from this package and merge into your .gitlab-ci.yml.

Any CI (shell script)

# Set environment variables:
export MEMNOX_PAT="your-token"
export MEMNOX_PROJECT_ID="your-project-uuid"

# Run the check:
npx -y @memnox/mcp ci --check deployment-readiness --project "$MEMNOX_PROJECT_ID" --token "$MEMNOX_PAT"

Or use the bundled shell script:

npx -y @memnox/mcp -- cat ./ci/check.sh | sh

Available CI Checks

| Check | What it does | Fails when | |---|---|---| | deployment-readiness | Open critical tasks, unresolved violations, orphan commits | --fail-on no_go (default) | | pr-review | PR against team decisions, violations, patterns | --fail-on blocked (default) | | violations | All open constraint violations | --fail-on critical (default) | | decision-health | Stale, violated, never-referenced decisions | --fail-on 50 (score below 50) | | scope-health | Sprint risk and confidence score | --fail-on critical (default) |

--fail-on values

deployment-readiness: no_go (default), caution

pr-review: blocked (default), needs_review

violations: critical (default), high, any

decision-health: any number 0–100 (fails if score is below that number)

scope-health: critical (default), high

--output json

Outputs the full result as JSON instead of human-readable text. Useful for parsing in pipelines:

RESULT=$(npx -y @memnox/mcp ci --check deployment-readiness \
  --project "$PROJECT_ID" --token "$TOKEN" --output json --no-fail)
VERDICT=$(echo "$RESULT" | jq -r '.verdict')

--no-fail

Run the check and print results without exiting non-zero. Useful for informational checks in pipelines.

Available MCP Tools (38)

| Category | Tools | |---|---| | Daily workflow | get_briefing, get_feed, get_next_task, get_standup_update | | Project | list_projects, get_project, get_project_narrative, get_catch_up | | Memory & search | get_memory, search_memory, ask_project, ask_workspace | | Pre-coding | get_context_bundle, get_implementation_brief, validate_implementation_plan, get_blast_radius | | Code review | get_pr_brief, suggest_reviewer | | Cross-source | get_reality_check | | Decisions | list_decisions, record_decision, suggest_decision, get_decision_health, trace_decision | | Violations | get_violations | | Tasks | list_tasks, create_task, update_task | | Sprint & planning | get_scope_health, get_risk_register, get_deployment_readiness | | Team intelligence | get_workspace_expertise, get_my_impact, get_offboarding_brief, get_meeting_prep, detect_recurring_blockers | | Workspace health | get_health_score | | Incident response | get_incident_runbook |

Full documentation: https://memnox.com/docs/mcp

Requirements

• Node.js 18 or later
• A Memnox account — https://app.memnox.com

License

MIT