Best for
- Developers working on large projects who need persistent AI memory.
- Teams want to integrate IDE agents and GitHub Copilot with shared context.
- Engineers managing multiple repositories who need unified project intelligence.
Memory Journal MCP Server is a powerful, feature-rich tool for developers and teams that need persistent context and GitHub integration. It has extensive security features, but careful configuration is required.
Strongest · Documentation 17/20 Weakest · Reliability 11/20
Static review · not runListed 2026-09-08
Read the FMRS scoring method →Runtime:Node.js · Docker
GITHUB_TOKEN
GitHub personal access token for Issues/PRs/Actions API access; generate in GitHub settings with repo, project, and read:org scopes.
MCP_AUTH_TOKEN
Bearer token for HTTP transport authentication; required for public binding.
PROJECT_REGISTRY
JSON map of repo names to { path, project_number } for multi-project auto-detection and routing.
ALLOWED_IO_ROOTS
Comma-separated absolute paths granting filesystem access to export/import and Code Mode tools; fail-closed by default.
DB_PATH
Location of the SQLite journal database file.
TEAM_DB_PATH
Path to the shared team database; required for team collaboration and Hush Protocol.
TEAM_AUTHOR
Overrides author name for team entries; defaults to git config user.name.
DEFAULT_PROJECT_NUMBER
Default GitHub Project number for auto-assignment when creating issues.
AUTO_REBUILD_INDEX
Set to true to rebuild the vector index on server startup.
MCP_HOST
HTTP bind host; use 0.0.0.0 for containers.
MCP_CORS_ORIGIN
Comma-separated allowed CORS origins for HTTP transport; blank (strict) by default.
TRUST_PROXY
Trust proxy headers for rate limiting and origin checks; default false.
PUBLIC_ORIGIN
Public origin URL for OAuth redirect URIs.
MCP_RATE_LIMIT_MAX
Max HTTP requests per minute per client IP; default 100.
LOG_LEVEL
Log verbosity: error, warn, info, debug; default info.
MCP_ENABLE_HSTS
Enable HSTS security header on HTTP responses; default false.
OAUTH_ENABLED
Set to true to enable OAuth 2.1 authentication (HTTP only).
OAUTH_ISSUER
OAuth issuer URL, e.g. a Keycloak realm endpoint.
OAUTH_AUDIENCE
Expected JWT audience claim.
OAUTH_JWKS_URI
JWKS endpoint for JWT signature verification.
OAUTH_ALLOW_PLAINTEXT_LOOPBACK
Allow plaintext HTTP loopback OAuth redirect URIs; default false.
OAUTH_CLOCK_TOLERANCE
Allowed clock skew in seconds for JWT verification; default 5.
CODE_MODE_MAX_RESULT_SIZE
Max size in bytes for mj_execute_code result payloads; default 102400.
CODEMODE_INTERNAL_FULL_ACCESS
Set to true to bypass tool filter constraints inside the Code Mode sandbox.
BRIEFING_ENTRY_COUNT
Number of journal entries in the session briefing; default 3.
BRIEFING_SUMMARY_COUNT
Number of session summaries in the briefing; default 1.
BRIEFING_INCLUDE_TEAM
Include team database entries in the briefing; default false.
BRIEFING_ISSUE_COUNT
Issues listed in the briefing; 0 = count only.
BRIEFING_PR_COUNT
PRs listed in the briefing; 0 = count only.
BRIEFING_PR_STATUS
Show PR status breakdown in the briefing; default false.
BRIEFING_MILESTONE_COUNT
Milestones listed in the briefing; default 3.
BRIEFING_WORKFLOW_COUNT
Workflow runs listed in the briefing; 0 = status only.
BRIEFING_WORKFLOW_STATUS
Show workflow status breakdown in the briefing; default false.
BRIEFING_COPILOT_REVIEWS
Aggregate Copilot review state in the briefing; default false.
RULES_FILE_PATH
Path to a user rules file exposed as memory://rules for agent awareness.
SKILLS_DIR_PATH
Path to a skills directory exposed as memory://skills.
MEMORY_JOURNAL_WORKFLOW_SUMMARY
Free-text workflow summary shown via memory://workflows.
INSTRUCTION_LEVEL
Briefing guidance depth: essential, standard (default), full.
PROJECT_LINT_CMD
Lint command for GitHub Commander validation gates; default npm run lint.
PROJECT_TYPECHECK_CMD
Typecheck command; default npm run typecheck.
PROJECT_BUILD_CMD
Build command; default npm run build.
PROJECT_TEST_CMD
Test command; default npm run test.
PROJECT_E2E_CMD
E2E test command; default empty = skip.
PROJECT_PACKAGE_MANAGER
Package manager override: npm, yarn, pnpm, bun; auto-detected from lockfile by default.
PROJECT_HAS_DOCKERFILE
Enable Docker audit steps; auto-detected by default.
COMMANDER_HITL_FILE_THRESHOLD
Human-in-the-loop checkpoint when changes touch more than N files; default 10.
COMMANDER_SECURITY_TOOLS
Comma-separated override for security tool auto-detection.
COMMANDER_BRANCH_PREFIX
Branch naming prefix for PRs; default fix.
AUDIT_LOG_PATH
Path for the JSONL telemetry log of write/admin tool calls; omit to disable.
AUDIT_REDACT
Default true redacts tool arguments in the telemetry log.
AUDIT_READS
Set to true to also log read-scoped tool calls; default false.
AUDIT_LOG_MAX_SIZE
Max telemetry file size in bytes before rotation; default 10485760.
MCP_METRICS_ENABLED
Set to false to disable in-memory tool call metrics; default true.
FLAG_VOCABULARY
Comma-separated Hush Protocol flag types; default blocker,needs_review,help_requested,fyi.
PRUNE_OLDER_THAN_DAYS
Soft-delete entries older than N days below the importance threshold on startup; 0 = disabled.
PRUNE_IMPORTANCE_THRESHOLD
Importance score threshold (0.0–1.0) below which entries are pruned; default 0.15.
MEMORY_JOURNAL_MCP_TOOL_FILTER
Controls exposed tool sets: presets like full, starter, readonly, or group exclusion syntax.
npm install -g memory-journal-mcpmcpServers in your MCP client config (e.g., Claude Desktop, Cursor).docker run -i --rm -v ./data:/app/data writenotenow/memory-journal-mcp:latest.{
"mcpServers": {
"memory-journal-mcp": {
"command": "memory-journal-mcp",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here",
"PROJECT_REGISTRY": "{\"my-repo\":{\"path\":\"/path/to/your/git/repo\",\"project_number\":1}}",
"ALLOWED_IO_ROOTS": "/path/to/your/git/repo"
}
}
}
}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"memory-journal-mcp": {
"command": "memory-journal-mcp",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here",
"PROJECT_REGISTRY": "{\"my-repo\":{\"path\":\"/path/to/your/git/repo\",\"project_number\":1}}",
"ALLOWED_IO_ROOTS": "/path/to/your/git/repo"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add memory-journal-mcp -e GITHUB_TOKEN=ghp_your_token_here -e 'PROJECT_REGISTRY={"my-repo":{"path":"/path/to/your/git/repo","project_number":1}}' -e ALLOWED_IO_ROOTS=/path/to/your/git/repo -- memory-journal-mcp
Run it in a terminal; replace any <…> placeholders with your own values first.
After adding the config and restarting your client, tools like create_entry and search_entries should appear in the tool list; you can also ask the agent to read memory://briefing — a returned project briefing confirms the connection.
Once connected, you can ask your AI assistant things like:
No matching tools
Listed from the project's documentation, not tested by this site.
Memory Journal MCP Server is an MCP server that provides project-level long-term memory for AI agents. It maintains persistent knowledge graphs to pass context seamlessly between AI sessions, eliminating "AI amnesia." Features include GitHub integration (issues, PRs, Actions, Kanban, milestones, etc.), dynamic project detection, hybrid search (keyword + semantic + date range), knowledge graph visualization, team collaboration (shared database + vector search + cross-project insights), Hush Protocol (async flags), and adaptive session briefings. It offers 70+ tools, 19 prompts, and 46 resources, plus a Code Mode that saves up to 90% tokens. Built with TypeScript, SQLite, and local embedding models, it is local-first and privacy-conscious.
Upstash's official server providing up-to-date third-party library docs for AI coding assistants
AI-powered NPM package analysis MCP server
An independent control layer that gives AI coding agents budgets, brakes, and receipts
GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language
Source revision f58eb155ec17 Data synced 2026-10-19 Read the FMRS scoring method