Skip to content
Notedigit
Get started

Connect Claude Code to your notes

Claude Code reads a Notedigit repository as a remote MCP server over HTTP. One command adds it, /mcp signs you in through Notedigit, and from then on Claude Code can search and read your notes while it works — playbooks, decisions, runbooks — without being able to change them.

Before you start

  • Notedigit is running on your server and the repository is connected (Check connection passed).
  • You are assigned to the repository. Access is per user, per repository.
  • You have copied the repository’s MCP endpoint from the MCP endpoint card in Notedigit (MCP client tab).
  • Claude Code is installed and you can run the claude command in a terminal.

The endpoint looks like this

https://notes.your-company.com/mcp/<repository-id>

  1. Step 1: Add the server

    Add the repository as an HTTP MCP server. Pick a short name you will recognise in /mcp, such as project-knowledge.

    Without a --scope flag the server is added for the current project only, on your machine. Use --scope user to have it in every project, or --scope project to write it to .mcp.json so everyone who clones the code base gets the same server (each person still signs in as themselves).

    claude mcp add --transport http project-knowledge \
  https://notes.your-company.com/mcp/<repository-id>

  2. Step 2: Sign in with /mcp

    Start Claude Code and run /mcp. The new server is listed as needing authentication; choose it and Claude Code opens your browser.

    Sign in to Notedigit if asked, check the consent screen — the repository and the account you are signed in as — and choose Authorize. The first time anyone on your team connects Claude Code, Notedigit marks it as an Unrecognized client; continue only if you started the connection yourself.

  3. Step 3: Or use a token for headless runs

    For CI jobs and machines without a browser, create a personal access token in Notedigit (Settings → Access tokens) and pass it as a header instead of signing in. The token acts as you and lasts 90 days.

    claude mcp add --transport http project-knowledge \
  https://notes.your-company.com/mcp/<repository-id> \
  --header "Authorization: Bearer $NOTEDIGIT_TOKEN"

  4. Step 4: Work with it

    Claude Code now has three read-only tools on the repository: search, read_file and list_files. Ask it to check your conventions before it writes code, or to find the decision behind a module before it changes it.

    Every call is recorded in Notedigit under MCP connections, with Claude Code as the client.

Book a demo