Skip to content

Conversation

@PeterZZZ
Copy link
Contributor

Purpose of the change

This PR adds comprehensive documentation for integrating MemMachine with Claude Code, Anthropic's official CLI tool. This enables Claude Code users to leverage persistent memory across sessions, improving the development experience for ongoing projects.

Description

Added a new documentation file docs/examples/claude_code_mcp.mdx that provides step-by-step instructions for setting up MemMachine with Claude Code. The guide includes:

  • Introduction to Claude Code and its integration with MemMachine
  • Prerequisites and Docker container setup
  • Two configuration methods:
    • Option A (Docker): Validated and recommended approach using .mcp.json configuration
    • Option B (Direct Command): Reference implementation for local installations (includes disclaimer as untested)
  • Testing and verification steps
  • Usage guidance for memory tools (add_memory and search_memory)
  • Troubleshooting section for common issues

This documentation follows the same format and structure as existing integration guides (mcp.mdx, etc.).

Fixes/Closes

N/A - This is a new documentation addition

Type of change

[Please delete options that are not relevant.]

  • Documentation update

How Has This Been Tested?

  • Manual verification (list step-by-step instructions)

    Manual Testing Performed:

    1. Started MemMachine Docker container using docker compose up -d
    2. Created .mcp.json in project root with Docker configuration (Option A)
    3. Launched Claude Code with claude command
    4. Verified MCP connection by checking /mcp command
    5. Tested add_memory by sharing preferences with Claude
    6. Started new conversation and tested search_memory by querying previous context
    7. Confirmed memory persistence across sessions

    Test Results:

    • Option A (Docker method): ✅ Fully tested and working
    • Option B (Direct command): ⚠️ Not tested - included as reference with disclaimer note

Checklist

[Please delete options that are not relevant.]

  • I have signed the commit(s) within this pull request
  • I have made corresponding changes to the documentation
  • I have checked my code and corrected any misspellings

Maintainer Checklist

  • Confirmed all checks passed
  • Contributor has signed the commit(s)
  • Reviewed the code
  • Run, Tested, and Verified the change(s) work as expected

Screenshots/Gifs

N/A - Documentation only (no UI changes to capture)

Further comments

Note on Option B: The direct command setup method (Option B) is included as a reference implementation following standard MCP stdio patterns from the Claude Desktop
documentation. However, it has not been tested with Claude Code specifically. A clear disclaimer has been added to the documentation to set appropriate user expectations. Users
encountering issues are directed to use the validated Docker method (Option A).

Future work: Community feedback on Option B would help validate or improve that configuration method.

Copy link
Contributor

@jealous jealous left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@jealous
Copy link
Contributor

jealous commented Nov 17, 2025

@sscargal could you help to review this? Thanks.

@sscargal
Copy link
Contributor

@SarahScargall I think we should create a new "Integrations" top-level category/tab and start adding this and other integrations (LangChain, LangGraph, etc) to that. I don't think "Examples" is the correct home for this type of document. The original intent of "Examples" was to point developers to code examples.

@SarahScargall
Copy link
Contributor

I am investigating this document and where it should reside within our Docs structure. Once a decision is made, I will update this PR.

Copy link
Contributor

@SarahScargall SarahScargall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving changes so it can be included with v0.2 integration.

@SarahScargall SarahScargall merged commit eaa1f0e into MemMachine:main Nov 25, 2025
25 of 26 checks passed
malatewang pushed a commit that referenced this pull request Nov 27, 2025
* Doc: Claude Code integrate with MemMachine MCP

* Doc: Claude Code integrate with MemMachine MCP--content

---------

Co-authored-by: Cedric Zhuang <cedric.zhuang@memverge.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants