LoginGet Started

Updates & Versioning

Keep your ContextForge MCP client up to date to get the latest features, bug fixes, and improvements.

Current Version

Check Your Installed Version

To see which version you currently have installed:

npm list -g contextforge-mcp

This will show something like: contextforge-mcp@0.1.71

How to Update

1Update to Latest Version (Recommended)

This is the simplest way to get the latest version:

npm update -g contextforge-mcp

This command updates to the latest version available on npm.

2Force Reinstall Latest

If the update command doesn't work, force a fresh install:

npm install -g contextforge-mcp@latest

This removes the old version and installs the latest one.

3Install Specific Version

If you need a specific version:

npm install -g contextforge-mcp@0.1.71

Replace 0.1.71 with the version you want.

Important: Restart Required

After updating the package, you must restart Claude Code for the changes to take effect.

For Claude Code (CLI):

  1. Close your current Claude Code session
  2. Exit the terminal (or run exit)
  3. Open a new terminal session
  4. Start Claude Code again

Why? Claude Code runs the MCP client as a background process. When you update the npm package, it updates the files on disk, but the old process is still running in memory. Restarting creates a new process with the updated code.

Verify the Update

After restarting Claude Code, verify the new version is active:

1. Check installed version:

npm list -g contextforge-mcp

2. Test with Claude Code:

Ask Claude to use a ContextForge tool. If you see improved error messages with helpful links and details, you're using the latest version!

Troubleshooting

Issue: "Version not updating"

If npm update doesn't work:

  1. Try the force reinstall method: npm install -g contextforge-mcp@latest
  2. Check npm cache: npm cache clean --force
  3. Then reinstall: npm install -g contextforge-mcp@latest

Issue: "Permission denied"

On macOS/Linux, you might need sudo:

sudo npm update -g contextforge-mcp

Issue: "Still seeing old error messages"

Make sure you restarted Claude Code after updating:

  1. Verify version: npm list -g contextforge-mcp
  2. Completely exit Claude Code
  3. Close the terminal
  4. Open a new terminal and start Claude Code

Issue: "EBADENGINE warning"

You might see a warning about Node.js version compatibility:

npm warn EBADENGINE Unsupported engine

This is usually safe to ignore. It's a warning from a development dependency and doesn't affect ContextForge functionality. If the update completes with "changed 1 package", you're good to go!

Recent Release Notes

Version 0.1.71

Current

Released: March 25, 2026

✨ Added:
  • Relationship-aware search — queries now discover related items through knowledge graph connections
  • include_relationships parameter for memory_query — see connections for each result
  • Obsidian vault import with YAML frontmatter parsing, wikilink relationship creation, and folder categories
  • memory_list_relationships — list all connections for a knowledge item
🐛 Fixed:
  • memory_query returning 0 results when using project_id — git spaces were included in search, causing timeouts
  • Projects endpoint showing inflated space count (included git spaces)

Version 0.1.70

Released: March 13, 2026

✨ Added:
  • tasks_add_comment — Add comments to tasks from Claude
  • tasks_list_comments — View all comments on a task
  • Comment count indicator in tasks_list output
  • Update notification in tool responses when a new MCP version is available
🔧 Improved:
  • Dashboard update banner with dismissible notification
  • Version notification system for all users
  • MCP version now reads from package.json (single source of truth)

Version 0.1.65

Released: March 11, 2026

✨ Changed:
  • tasks_delete now performs hard delete with full cascade cleanup (comments, activity, notifications)
  • Delete button on all task cards and rows directly from the list view
🔧 Improved:
  • Infinite scroll preserves position when deleting items
  • Delete button visibility improved in dark mode
  • CI auto-pr workflow skips when no unique commits exist

Version 0.1.64

Released: March 10, 2026

🔒 Security:
  • Fixed authorization bypass in @hono/node-server (High CVE)
  • Fixed cross-client data leak in @modelcontextprotocol/sdk (High CVE)
  • Fixed arbitrary file write in rollup (High CVE)
🔧 Improved:
  • Updated all dependencies to latest secure versions

Version 0.1.49

Released: January 29, 2026

✨ Added:
  • issues_delete - Delete tasks by ID or short_id (soft delete)
  • Create Task dialog in dashboard (replaces navigation to /new page)
  • Delete Task button in task detail page (owners only)
🔧 Improved:
  • Backend supports DELETE by id or short_id
  • Better UX for task management from dashboard

Version 0.1.22

Released: January 15, 2026

✨ Added:
  • npx contextforge-setup - Interactive setup wizard for easy configuration
  • npx contextforge-setup --verify - Check current configuration status
🔧 Improved:
  • Simplified installation process - no more long commands to memorize
  • Automatic detection of existing ContextForge configuration

Version 0.1.21

Released: January 15, 2026

✨ Added:
  • memory_link_project - Link local directories to cloud projects
  • memory_unlink_project - Remove project link from directory
  • memory_current_project - View linked project and its spaces
  • .contextforge config file for automatic project context
🔧 Improved:
  • memory_list_spaces now auto-filters by linked project
  • Updated help text with project linking documentation

Version 0.1.20

Released: January 15, 2026

✨ Added:
  • memory_delete_project - Delete projects with cascade delete of all spaces and items
  • Delete Project button in dashboard project detail page
🔧 Improved:
  • Backend now supports cascade delete for projects
  • Updated documentation for delete operations

Version 0.1.18

Released: January 15, 2026

✨ Added:
  • Projects feature for organizing spaces (hierarchy: Projects → Spaces)
  • memory_move_space - Move spaces between projects
  • memory_delete_space - Delete spaces and their items
  • memory_list_projects and memory_create_project tools
  • Project detail page in dashboard
  • Move and Delete buttons for spaces in dashboard UI
🔧 Improved:
  • Sidebar reordered: Usage now before Projects
  • Better usage display for over-limit scenarios
  • Fixed JWT verification on edge functions

Version 0.1.15

Released: January 14, 2026

✨ Added:
  • Multi-space search capabilities
  • Space names support in queries
  • User-friendly error messages

Version 0.1.4

Released: January 12, 2026

✨ Added:
  • Git integration tools (connect, sync, history)
  • Snapshot management (create, restore, delete)
  • Import/Export functionality
  • Batch operations for deletion

View full changelog on GitHub Releases

Update Best Practices

+

Check for updates regularly

Run npm outdated -g to see if updates are available

+

Always restart after updating

Remember to restart Claude Code to use the new version

+

Test after updating

Try a simple operation to make sure everything works

-

Breaking changes are rare

Minor updates (0.1.x) are always backwards compatible

Need Help?

If you encounter any issues while updating: