Connect Neutrally to your editor

Bring your Neutrally conversations, memory, and context into VS Code, Cursor, or Claude Code via MCP.

Prerequisites

Node.js 18 or later installed
A Neutrally account (sign up at neutrally.app)
VS Code, Cursor, or Claude Code installed

Setup

Run this command in your terminal:

Terminal
npx neutrally setup
1

Press Enter to open your browser

Neutrally will open in your default browser for authentication.

2

Log in and approve the connection

Sign in to your Neutrally account and click "Approve connection" to grant your editor access.

3

Choose which editors to configure

The CLI will detect your installed editors and offer to configure each one automatically.

4

Restart your editor

Close and reopen your editor to activate Neutrally.

Verify it works

Claude Code

Ask Claude: "Can you search my Neutrally conversations?" If it uses the neutrally_search tool, you're connected.

Check status

Run this to see your connection status and configured editors:

npx neutrally status

Available tools

Once connected, your editor has access to these Neutrally tools:

neutrally_search

Search your conversations by keyword. Searches titles, summaries, and message content. Optionally search within a specific conversation.

neutrally_list_conversations

List your recent conversations with titles and summaries. Supports date filtering.

neutrally_fetch_conversation

Fetch the full details of a specific conversation, including all messages.

neutrally_get_context

Get your global context: interests, projects, tech stack, and recent summaries.

neutrally_recent

Get the most recent messages across all conversations.

neutrally_extract_code

Extract all code blocks from a conversation with language tags.

neutrally_summarize_activity

Get a synthesis of your recent activity across all conversations.

Troubleshooting

Editor doesn't see Neutrally tools

Make sure you restarted your editor after running setup. In Claude Code, type /mcp to check connected servers.

Login timed out

The browser auth window expires after 5 minutes. Run npx neutrally setup again.

"Not logged in" error in tools

Your token may have expired. Run npx neutrally login to re-authenticate.

Search returns no results

Make sure you have conversations in Neutrally. The search covers titles, summaries, and message content.

Need help? Contact support@neutrally.app