Summary
ContextStream wires your AI assistant into a persistent memory and knowledge layer across your codebase, conversations, and team tools. It exposes semantic search over code, a lessons system that captures failures and decisions, session memory that survives context window pressure, and direct integrations with GitHub, Slack, and Notion. The server indexes your project locally and syncs with a hosted service, then surfaces relevant context automatically through a SmartRouter that analyzes each message. You get dependency graph queries, multi-modal media indexing, and hybrid search without manually feeding files into prompts. Setup drops an MCP config into Claude Desktop, Cursor, VS Code with Copilot, or OpenCode, and the tools hook in transparently from there.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
59 tools
mcp_server_versionReturn the running ContextStream MCP server package version Access: Free
Return the running ContextStream MCP server package version Access: Free
No parameter schema in public metadata yet.
auth_meFetch authenticated user profile Access: Free
Fetch authenticated user profile Access: Free
No parameter schema in public metadata yet.
workspaces_listList accessible workspaces (paginated list: items, total, page, per_page, has_next, has_prev). Access: Free2 params
List accessible workspaces (paginated list: items, total, page, per_page, has_next, has_prev). Access: Free
Parameters* required
pagenumberPage number for pagination.
page_sizenumberResults per page.
projects_listList projects (optionally by workspace; paginated list: items, total, page, per_page, has_next, has_prev). Access: Free3 params
List projects (optionally by workspace; paginated list: items, total, page, per_page, has_next, has_prev). Access: Free
Parameters* required
pagenumberPage number for pagination.
page_sizenumberResults per page.
workspace_idstringWorkspace ID (UUID).
projects_createCreate a new project within a workspace. Use this when you need to create a project for a specific folder/codebase. If workspace_id is not provided, uses the current session's workspace. Optionally associates a local folder and generates AI editor rules. Access: Free Access: Free5 params
Create a new project within a workspace. Use this when you need to create a project for a specific folder/codebase. If workspace_id is not provided, uses the current session's workspace. Optionally associates a local folder and generates AI editor rules. Access: Free Access: Free
Parameters* required
descriptionstringProject description
folder_pathstringOptional: Local folder path to associate with this project
generate_editor_rulesbooleanGenerate AI editor rules in folder_path (requires folder_path)
namestringProject name
workspace_idstringWorkspace ID (uses current session workspace if not provided)
projects_updateUpdate a project (rename or change description) Access: Free3 params
Update a project (rename or change description) Access: Free
Parameters* required
descriptionstringShort description.
namestringName for the resource.
project_idstringProject ID (UUID).
projects_indexTrigger indexing for a project Access: Free1 params
Trigger indexing for a project Access: Free
Parameters* required
project_idstringProject ID (UUID).
search_semanticSemantic vector search Access: Free4 params
Semantic vector search Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
querystringSearch query string.
workspace_idstringWorkspace ID (UUID).
search_hybridHybrid search (semantic + keyword) Access: Free4 params
Hybrid search (semantic + keyword) Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
querystringSearch query string.
workspace_idstringWorkspace ID (UUID).
search_keywordKeyword search Access: Free4 params
Keyword search Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
querystringSearch query string.
workspace_idstringWorkspace ID (UUID).
memory_create_eventCreate a memory event for a workspace/project Access: Free6 params
Create a memory event for a workspace/project Access: Free
Parameters* required
contentstringFull content/body.
event_typestringInput parameter: event type.
metadataobjectInput parameter: metadata.
project_idstringProject ID (UUID).
titlestringShort descriptive title.
workspace_idstringWorkspace ID (UUID).
memory_list_eventsList memory events (optionally scoped) Access: Free3 params
List memory events (optionally scoped) Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_create_nodeCreate a knowledge node with optional relations Access: Free6 params
Create a knowledge node with optional relations Access: Free
Parameters* required
contentstringFull content/body.
node_typestringInput parameter: node type.
project_idstringProject ID (UUID).
relationsarrayInput parameter: relations.
titlestringShort descriptive title.
workspace_idstringWorkspace ID (UUID).
memory_list_nodesList knowledge graph nodes Access: Free3 params
List knowledge graph nodes Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_searchSearch memory events/notes Access: Free4 params
Search memory events/notes Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
querystringSearch query string.
workspace_idstringWorkspace ID (UUID).
memory_decisionsList decision summaries from workspace memory Access: Free4 params
List decision summaries from workspace memory Access: Free
Parameters* required
categorystringOptional category filter. If not specified, returns all decisions regardless of category.
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_relatedFind related nodes in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)4 params
Find related nodes in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
limitnumberMaximum number of results to return.
node_idstringNode ID (UUID).
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_pathFind path between two nodes Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)4 params
Find path between two nodes Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
source_idstringID for the source.
target_idstringID for the target.
workspace_idstringWorkspace ID (UUID).
graph_decisionsDecision history in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)3 params
Decision history in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_dependenciesDependency graph query Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)3 params
Dependency graph query Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)
Parameters* required
include_transitivebooleanInclude transitive dependencies.
max_depthnumberMaximum traversal depth.
targetobjectInput parameter: target.
graph_call_pathFind call path between two targets Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)3 params
Find call path between two targets Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
max_depthnumberMaximum traversal depth.
sourceobjectInput parameter: source.
targetobjectInput parameter: target.
graph_impactAnalyze impact of a target node Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)2 params
Analyze impact of a target node Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)
Parameters* required
max_depthnumberMaximum traversal depth.
targetobjectInput parameter: target.
graph_ingestBuild and persist the dependency graph for a project. Runs async by default (wait=false) and can take a few minutes for larger repos. Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)2 params
Build and persist the dependency graph for a project. Runs async by default (wait=false) and can take a few minutes for larger repos. Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
waitbooleanIf true, wait for ingestion to finish before returning. Defaults to false (async).
projects_getGet project details by ID Access: Free1 params
Get project details by ID Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_overviewGet project overview with summary information Access: Free1 params
Get project overview with summary information Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_statisticsGet project statistics (files, lines, complexity) Access: Free1 params
Get project statistics (files, lines, complexity) Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_filesList all indexed files in a project Access: Free1 params
List all indexed files in a project Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_index_statusGet project indexing status Access: Free1 params
Get project indexing status Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_ingest_localRead ALL files from a local directory and ingest them for indexing. This indexes your entire project by reading files in batches. Automatically detects code files and skips ignored directories like node_modules, target, dist, etc. Access: Free4 params
Read ALL files from a local directory and ingest them for indexing. This indexes your entire project by reading files in batches. Automatically detects code files and skips ignored directories like node_modules, target, dist, etc. Access: Free
Parameters* required
overwritebooleanAllow overwriting existing files when write_to_disk is enabled
pathstringLocal directory path to read files from
project_idstringProject to ingest files into (defaults to current session project)
write_to_diskbooleanWhen true, write files to disk under QA_FILE_WRITE_ROOT before indexing (for testing/QA)
workspaces_getGet workspace details by ID Access: Free1 params
Get workspace details by ID Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
memory_get_eventGet a specific memory event by ID with FULL content (not truncated). Use this when you need the complete content of a memory event, not just the preview returned by search/recall. Access: Free1 params
Get a specific memory event by ID with FULL content (not truncated). Use this when you need the complete content of a memory event, not just the preview returned by search/recall. Access: Free
Parameters* required
event_idstringThe UUID of the memory event to retrieve
memory_update_eventUpdate a memory event Access: Free4 params
Update a memory event Access: Free
Parameters* required
contentstringFull content/body.
event_idstringEvent ID (UUID).
metadataobjectInput parameter: metadata.
titlestringShort descriptive title.
memory_delete_eventDelete a memory event Access: Free1 params
Delete a memory event Access: Free
Parameters* required
event_idstringEvent ID (UUID).
memory_timelineGet chronological timeline of memory events for a workspace Access: Free1 params
Get chronological timeline of memory events for a workspace Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
memory_summaryGet condensed summary of workspace memory Access: Free1 params
Get condensed summary of workspace memory Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
graph_circular_dependenciesDetect circular dependencies in project code Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)1 params
Detect circular dependencies in project code Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
graph_unused_codeDetect unused code in project Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)1 params
Detect unused code in project Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
session_initInitialize a new conversation session and automatically retrieve relevant context. This is the FIRST tool AI assistants should call when starting a conversation. Returns: workspace info, project info, recent memory, recent decisions, relevant context, and high-priority lessons...9 params
Initialize a new conversation session and automatically retrieve relevant context. This is the FIRST tool AI assistants should call when starting a conversation. Returns: workspace info, project info, recent memory, recent decisions, relevant context, and high-priority lessons...
Parameters* required
allow_no_workspacebooleanIf true, allow session_init to return connected even if no workspace is resolved (workspace-level tools may not work).
auto_indexbooleanAutomatically create and index project from IDE workspace (default: true)
context_hintstringRECOMMENDED: Pass the user's first message here for semantic search. This finds relevant context from ANY time, not just recent items.
folder_pathstringCurrent workspace/project folder path (absolute). Use this when IDE roots are not available.
include_decisionsbooleanInclude recent decisions (default: true)
include_recent_memorybooleanInclude recent memory events (default: true)
project_idstringProject to initialize context for
session_idstringCustom session ID (auto-generated if not provided)
workspace_idstringWorkspace to initialize context for
session_toolsGet an ultra-compact list of all available ContextStream MCP tools. Use this when you need to know what tools are available without reading full descriptions. Returns a token-efficient tool catalog (~120 tokens) organized by category. Format options: - 'grouped' (default): Cat...2 params
Get an ultra-compact list of all available ContextStream MCP tools. Use this when you need to know what tools are available without reading full descriptions. Returns a token-efficient tool catalog (~120 tokens) organized by category. Format options: - 'grouped' (default): Cat...
Parameters* required
categorystringFilter to specific category: Session, Search, Memory, Knowledge, Graph, Workspace, Project, AI
formatstringOutput format: grouped (default, ~120 tokens), minimal (~80 tokens), or full (~200 tokens)one of
grouped · minimal · fulldefault: groupedsession_get_user_contextRetrieve user preferences, coding style, and persona from memory. Use this to understand how the user likes to work and adapt your responses accordingly. Access: Free1 params
Retrieve user preferences, coding style, and persona from memory. Use this to understand how the user likes to work and adapt your responses accordingly. Access: Free
Parameters* required
workspace_idstringWorkspace to get user context from
workspace_associateAssociate a folder/repo with a workspace after user selection. Call this after session_init returns status='requires_workspace_selection' and the user has chosen a workspace. This persists the selection to .contextstream/config.json so future sessions auto-connect. Optionally...5 params
Associate a folder/repo with a workspace after user selection. Call this after session_init returns status='requires_workspace_selection' and the user has chosen a workspace. This persists the selection to .contextstream/config.json so future sessions auto-connect. Optionally...
Parameters* required
create_parent_mappingbooleanAlso create a parent folder mapping (e.g., /dev/maker/* -> workspace)
folder_pathstringAbsolute path to the folder/repo to associate
generate_editor_rulesbooleanGenerate AI editor rules for Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, and Aider
workspace_idstringWorkspace ID to associate with
workspace_namestringWorkspace name for reference
workspace_bootstrapCreate a new workspace (user-provided name) and onboard the current folder as a project. This is useful when session_init returns status='requires_workspace_name' (no workspaces exist yet) or when you want to create a new workspace for a repo. Behavior: - Creates a workspace w...8 params
Create a new workspace (user-provided name) and onboard the current folder as a project. This is useful when session_init returns status='requires_workspace_name' (no workspaces exist yet) or when you want to create a new workspace for a repo. Behavior: - Creates a workspace w...
Parameters* required
auto_indexbooleanAutomatically create and index project from folder (default: true)
context_hintstringOptional context hint for session initialization
create_parent_mappingbooleanAlso create a parent folder mapping (e.g., /dev/company/* -> workspace)
descriptionstringOptional workspace description
folder_pathstringAbsolute folder path (defaults to IDE root/cwd)
generate_editor_rulesbooleanGenerate AI editor rules in the folder for automatic ContextStream usage
visibilitystringWorkspace visibility (default: private)one of
private · publicworkspace_namestringName for the new workspace (ask the user)
session_captureAutomatically capture and store important context from the conversation. Use this to persist decisions, insights, preferences, or important information. Access: Free8 params
Automatically capture and store important context from the conversation. Use this to persist decisions, insights, preferences, or important information. Access: Free
Parameters* required
contentstringFull content/details to capture
event_typestringType of context being capturedone of
conversation · decision · insight · preference · task · bugimportancestringImportance levelone of
low · medium · high · criticalproject_idstringProject ID (UUID).
session_idstringSession ID to associate with this capture
tagsarrayTags for categorization
titlestringBrief title for the captured context
workspace_idstringWorkspace ID (UUID).
session_capture_lessonCapture a lesson learned from a mistake or correction. Use this when the user corrects you, expresses frustration, or points out an error. These lessons are surfaced in future sessions to prevent repeating the same mistakes. Example triggers: - User says "No, you should..." or...9 params
Capture a lesson learned from a mistake or correction. Use this when the user corrects you, expresses frustration, or points out an error. These lessons are surfaced in future sessions to prevent repeating the same mistakes. Example triggers: - User says "No, you should..." or...
Parameters* required
categorystringCategory of the lessonone of
workflow · code_quality · verification · communication · project_specificimpactstringWhat went wrong (e.g., "Production 404 errors - broken landing page")
keywordsarrayKeywords for matching in future contexts (e.g., ["git", "images", "assets", "push"])
preventionstringHow to prevent in future (e.g., "Run git status to check untracked files before pushing")
project_idstringProject ID (UUID).
severitystringSeverity: critical for production issues, high for breaking changes, medium for workflow, low for minorone of
low · medium · high · criticaldefault: mediumtitlestringLesson title - what to remember (e.g., "Always verify assets in git before pushing")
triggerstringWhat action caused the problem (e.g., "Pushed code referencing images without committing them")
workspace_idstringWorkspace ID (UUID).
session_get_lessonsRetrieve lessons learned from past mistakes and corrections. Use this to check for relevant warnings before taking actions that have caused problems before. Returns lessons filtered by: - Query: semantic search for relevant lessons - Category: workflow, code_quality, verificat...6 params
Retrieve lessons learned from past mistakes and corrections. Use this to check for relevant warnings before taking actions that have caused problems before. Returns lessons filtered by: - Query: semantic search for relevant lessons - Category: workflow, code_quality, verificat...
Parameters* required
categorystringFilter by categoryone of
workflow · code_quality · verification · communication · project_specificlimitnumberMaximum lessons to returndefault: 10
project_idstringProject ID (UUID).
querystringSearch for relevant lessons (e.g., "git push images")
severitystringFilter by minimum severityone of
low · medium · high · criticalworkspace_idstringWorkspace ID (UUID).
session_smart_searchSearch memory with automatic context enrichment. Returns memory matches, relevant code, and related decisions in one call. Access: Free5 params
Search memory with automatic context enrichment. Returns memory matches, relevant code, and related decisions in one call. Access: Free
Parameters* required
include_decisionsbooleanInclude related decisions (default: true)
include_relatedbooleanInclude related context (default: true)
project_idstringProject ID (UUID).
querystringWhat to search for
workspace_idstringWorkspace ID (UUID).
session_rememberQuick way to store something in memory. Use natural language. Example: "Remember that I prefer TypeScript strict mode" or "Remember we decided to use PostgreSQL" Access: Free5 params
Quick way to store something in memory. Use natural language. Example: "Remember that I prefer TypeScript strict mode" or "Remember we decided to use PostgreSQL" Access: Free
Parameters* required
await_indexingbooleanIf true, wait for indexing to complete before returning. This ensures the content is immediately searchable.
contentstringWhat to remember (natural language)
importancestringInput parameter: importance.one of
low · medium · highproject_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_recallQuick way to recall relevant context. Use natural language. Example: "What were the auth decisions?" or "What are my TypeScript preferences?" Access: Free3 params
Quick way to recall relevant context. Use natural language. Example: "What were the auth decisions?" or "What are my TypeScript preferences?" Access: Free
Parameters* required
project_idstringProject ID (UUID).
querystringWhat to recall (natural language)
workspace_idstringWorkspace ID (UUID).
generate_editor_rulesGenerate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider). These rules instruct the AI to automatically use ContextStream for memory and context. Supported editors: codex, windsurf, cursor, cline, kilo, roo, claude, aider Access: Free8 params
Generate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider). These rules instruct the AI to automatically use ContextStream for memory and context. Supported editors: codex, windsurf, cursor, cline, kilo, roo, claude, aider Access: Free
Parameters* required
additional_rulesstringAdditional project-specific rules to append
dry_runbooleanIf true, return content without writing files
editorsarrayWhich editors to generate rules for. Defaults to all.
folder_pathstringAbsolute path to the project folder
modestringRule verbosity mode (default: minimal)one of
minimal · fullproject_namestringProject name to include in rules
workspace_idstringWorkspace ID to include in rules
workspace_namestringWorkspace name to include in rules
session_summaryGet a compact, token-efficient summary of workspace context (~500 tokens). This is designed to replace loading full chat history in AI prompts. Returns: workspace/project info, top decisions (titles only), preferences, memory count. Use this at conversation start instead of lo...3 params
Get a compact, token-efficient summary of workspace context (~500 tokens). This is designed to replace loading full chat history in AI prompts. Returns: workspace/project info, top decisions (titles only), preferences, memory count. Use this at conversation start instead of lo...
Parameters* required
max_tokensnumberMaximum tokens for summary (default: 500)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_compressExtract and store key information from chat history as memory events. This allows clearing chat history while preserving important context. Use at conversation end or when context window is getting full. Extracts: - Decisions made - User preferences learned - Insights discover...4 params
Extract and store key information from chat history as memory events. This allows clearing chat history while preserving important context. Use at conversation end or when context window is getting full. Extracts: - Decisions made - User preferences learned - Insights discover...
Parameters* required
chat_historystringThe chat history to compress and extract from
extract_typesarrayTypes of information to extract (default: all)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_deltaGet new context added since a specific timestamp. Useful for efficient context synchronization without reloading everything. Returns: - Count of new decisions and memory events - List of new items with titles and timestamps Use case: AI can track what's new since last session_...4 params
Get new context added since a specific timestamp. Useful for efficient context synchronization without reloading everything. Returns: - Count of new decisions and memory events - List of new items with titles and timestamps Use case: AI can track what's new since last session_...
Parameters* required
limitnumberMaximum items to return (default: 20)
project_idstringProject ID (UUID).
sincestringISO timestamp to get changes since (e.g., "2025-12-05T00:00:00Z")
workspace_idstringWorkspace ID (UUID).
context_smart**CALL THIS BEFORE EVERY AI RESPONSE** to get relevant context. This is the KEY tool for token-efficient AI interactions. It: 1. Analyzes the user's message to understand what context is needed 2. Retrieves only relevant context in a minified, token-efficient format 3. Replace...5 params
**CALL THIS BEFORE EVERY AI RESPONSE** to get relevant context. This is the KEY tool for token-efficient AI interactions. It: 1. Analyzes the user's message to understand what context is needed 2. Retrieves only relevant context in a minified, token-efficient format 3. Replace...
Parameters* required
formatstringContext format (default: minified)one of
minified · readable · structuredmax_tokensnumberMaximum tokens for context (default: 800)
project_idstringProject ID (UUID).
user_messagestringThe user message to analyze and get context for
workspace_idstringWorkspace ID (UUID).
reminders_listList all reminders for the current user. Returns: reminders with title, content, remind_at, priority, status, and keywords. Can filter by status (pending, completed, dismissed, snoozed) and priority (low, normal, high, urgent). Use this to see what reminders you have set. Acce...5 params
List all reminders for the current user. Returns: reminders with title, content, remind_at, priority, status, and keywords. Can filter by status (pending, completed, dismissed, snoozed) and priority (low, normal, high, urgent). Use this to see what reminders you have set. Acce...
Parameters* required
limitnumberMaximum reminders to return (default: 20)
prioritystringFilter by priorityone of
low · normal · high · urgentproject_idstringProject ID (UUID).
statusstringFilter by statusone of
pending · completed · dismissed · snoozedworkspace_idstringWorkspace ID (UUID).
reminders_activeGet active reminders that are pending, overdue, or due soon. Returns: reminders with urgency levels (overdue, due_soon, today, upcoming). Optionally provide context (e.g., current task description) to get contextually relevant reminders. Use this to see what reminders need att...4 params
Get active reminders that are pending, overdue, or due soon. Returns: reminders with urgency levels (overdue, due_soon, today, upcoming). Optionally provide context (e.g., current task description) to get contextually relevant reminders. Use this to see what reminders need att...
Parameters* required
contextstringOptional context to match relevant reminders (e.g., current task)
limitnumberMaximum reminders to return (default: 10)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
reminders_createCreate a new reminder for a specific date/time. Set reminders to be notified about tasks, follow-ups, or important dates. Priority levels: low, normal, high, urgent Recurrence: daily, weekly, monthly (optional) Example: Create a reminder to "Review PR #123" for tomorrow at 10a...8 params
Create a new reminder for a specific date/time. Set reminders to be notified about tasks, follow-ups, or important dates. Priority levels: low, normal, high, urgent Recurrence: daily, weekly, monthly (optional) Example: Create a reminder to "Review PR #123" for tomorrow at 10a...
Parameters* required
contentstringReminder details/description
keywordsarrayKeywords for contextual surfacing
prioritystringPriority level (default: normal)one of
low · normal · high · urgentproject_idstringProject ID (UUID).
recurrencestringRecurrence patternone of
daily · weekly · monthlyremind_atstringWhen to remind (ISO 8601 datetime, e.g., "2025-01-15T10:00:00Z")
titlestringReminder title (brief, descriptive)
workspace_idstringWorkspace ID (UUID).
reminders_snoozeSnooze a reminder until a later time. Use this to postpone a reminder without dismissing it. Common snooze durations: - 1 hour: add 1 hour to current time - 4 hours: add 4 hours - Tomorrow: next day at 9am - Next week: 7 days from now Access: Free2 params
Snooze a reminder until a later time. Use this to postpone a reminder without dismissing it. Common snooze durations: - 1 hour: add 1 hour to current time - 4 hours: add 4 hours - Tomorrow: next day at 9am - Next week: 7 days from now Access: Free
Parameters* required
reminder_idstringID of the reminder to snooze
untilstringWhen to resurface the reminder (ISO 8601 datetime)
reminders_completeMark a reminder as completed. Use this when the task or action associated with the reminder is done. Access: Free1 params
Mark a reminder as completed. Use this when the task or action associated with the reminder is done. Access: Free
Parameters* required
reminder_idstringID of the reminder to complete
reminders_dismissDismiss a reminder without completing it. Use this to remove a reminder that is no longer relevant. Access: Free1 params
Dismiss a reminder without completing it. Use this to remove a reminder that is no longer relevant. Access: Free
Parameters* required
reminder_idstringID of the reminder to dismiss
ContextStream MCP Server
Persistent memory. Millisecond code search.
Your agent knows code. Give it the decisions behind yours.
Connect your code, docs, and conversations so your agents can find the right files, recall saved decisions, and build on past work across sessions and tools.
Start free with MCP
10,000 monthly credits. No credit card required.
Works with Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Qwen Code, Kimi Code, Muse Code, ZCode, Zed, and more MCP clients, on Claude, GPT, Gemini, Kimi, GLM, Qwen, and other models. Create your account or sign in during MCP onboarding. No separate website signup needed.
macOS and Linux
curl -fsSL https://contextstream.io/scripts/mcp.sh | bash
Windows PowerShell
irm https://contextstream.io/scripts/mcp.ps1 | iex
Paste the command into your terminal and follow onboarding to connect your project and supported editor. Restart your editor after setup.
What gets installed and indexed? · Supported clients · Setup guide · Prefer to start on the web?
Make the next session useful
Ask your connected agent:
Use ContextStream to find the files relevant to my next change. Cite the sources and retrieve any saved project decisions that should guide the work.
Then ask it to save a real decision and its reason. Start a new session and retrieve that decision without explaining it again. Indexing supplies code context; it cannot recover every undocumented decision.
Proof and data controls
95 ms median code search in our published benchmark. This is the measured successful-response median for the disclosed configuration, not a latency guarantee. See results, methodology, and limitations.
Scoped access. Traceable sources. Configurable capture. Indexing sends eligible source contents to ContextStream for hosted search. Transcript saving and local Git metadata capture are on by default and can be turned off. Review data handling and controls before connecting sensitive projects.
Other installation options and troubleshooting
npm (Node.js 20+)
npx -y @contextstream/mcp-server@latest setup
The npm launcher downloads the native Rust binary for your platform and verifies its SHA-256 checksum. Pin an exact package version for production automation.
Hosted MCP without a local process
For clients supporting Streamable HTTP and OAuth, the hosted endpoint is:
https://mcp.contextstream.io/mcp?default_context_mode=fast
Supported clients lists one-line add commands for Claude Code, Codex, Gemini CLI, Qwen Code, Copilot CLI, and Droid, and one-click install for VS Code. Use the MCP documentation for other clients and stdio alternatives. A hosted connection alone does not sync your local checkout.
Preview or diagnose setup
contextstream-mcp setup --dry-run
contextstream-mcp doctor --scope=all --only-configured
Scripted and CI setup
For automation, wrap the install in pipefail so it fails when the download
fails, instead of reporting success after installing nothing:
bash -o pipefail -c 'curl -fsSL https://contextstream.io/scripts/mcp.sh | bash'
setup --yes reads the key from CONTEXTSTREAM_API_KEY or saved credentials,
and needs --workspace-id when the account has more than one workspace:
export CONTEXTSTREAM_API_KEY=... # or: printf %s "$KEY" | contextstream-mcp configure --api-key-stdin
contextstream-mcp setup --yes --editors=claude --workspace-id=<UUID> --project-path=.
Open source and contributing
This repository contains the MIT-licensed Rust MCP server, client, editor setup, and release tooling. The hosted backend is separate and is not included here. See the architecture, release integrity, and latest release.
cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace
Use the pinned Rust toolchain. For contribution checks and commit sign-off, read CONTRIBUTING.md. Report vulnerabilities using SECURITY.md. See LICENSE, NOTICE, and GOVERNANCE.md for licensing, trademarks, and project governance.
Let humans be human.
Docs · Pricing · Integrations · Benchmarks
Optional deep project learning
Deep project learning starts off for new accounts. Plain contextstream-mcp setup --yes
preserves your current choice. To review consent, run
contextstream-mcp configure --account-learning on and confirm on the signed-in
privacy page. To withdraw, run contextstream-mcp configure --account-learning off.
Agents cannot consent for you. Doctor and init show status only. See
data handling and controls.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Categories
Registryactive
Package@contextstream/mcp-server
TransportSTDIO
UpdatedJan 2, 2026
