graphiti-mcp-usage

Graphiti MCP tools capture knowledge by structuring entries as Preferences, Procedures, and Facts within a screengraph. Search existing entries first, then use add_episode to record new requirements, tagging each entry for efficient retrieval and reuse across your workflow.

Procedures document workflows and processes you follow repeatedly; Facts capture relationships and data attributes. Structuring knowledge this way ensures consistency and makes both searchable and reusable through the MCP search_nodes and search_facts tools.

Use search_nodes within the screengraph group_id to find existing Preferences or Procedures matching your task. Reviewing matches before capturing new requirements prevents duplication and lets you reuse documented workflows.

Tag every entry added via add_episode with meaningful labels that describe the preference, procedure, or fact. Consistent tagging ensures you can quickly locate and retrieve related knowledge later using search_nodes across your screengraph scope.

Yes. When adding complex requirements with add_episode, break them into smaller, focused entries—each capturing a distinct Preference, Procedure, or Fact. This improves clarity, reusability, and makes updates and searches more efficient.

Use add_episode to record updates as new entries within the screengraph, applying tags that link them to previous versions. This maintains an audit trail while keeping your knowledge graph current and organized.