Junê MCP Server

Name: Junê MCP Server
Author: io.github.Junemind

io.github.Junemind/june-mcp

Repository Registry

What is the Junê MCP server?

Shared, cited knowledge-graph memory for agents — ask, search, and remember against a June endpoint

How to install Junê

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

JUNE_BASE_URL
required
Your June endpoint, e.g. http://localhost:8000 (the Junê desktop app's local engine, your own june-local service, or a hosted Team workspace)
JUNE_CANVAS
required
The canvas (workspace) to bind this connection to — a name (e.g. 'work') or a canvas id; names resolve at startup and ambiguous names fail closed
JUNE_API_KEY
required
secret
Your June API key (set JUNE_ALLOW_ANON=1 instead to explicitly opt out for keyless local setups)
JUNE_LLM_KEY
secret
Bring-your-own LLM key for cited answers — forwarded per-request as a header, never logged or stored on the service
JUNE_CANVAS_CREATE
Set to 1 to create the named canvas on first run if it doesn't exist yet (refused in read-only mode)
JUNE_READONLY
Set to 1 to hide and refuse all write tools (memory becomes read-only)
JUNE_FILES_ROOT
Opt-in directory agents may upload files from via june_ingest_file — unset means that tool doesn't exist

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "june-mcp": {
      "command": "uvx",
      "args": [
        "june-mcp"
      ],
      "env": {
        "JUNE_BASE_URL": "<YOUR_JUNE_BASE_URL>",
        "JUNE_CANVAS": "<YOUR_JUNE_CANVAS>",
        "JUNE_API_KEY": "<YOUR_JUNE_API_KEY>",
        "JUNE_LLM_KEY": "<YOUR_JUNE_LLM_KEY>",
        "JUNE_CANVAS_CREATE": "<YOUR_JUNE_CANVAS_CREATE>",
        "JUNE_READONLY": "<YOUR_JUNE_READONLY>",
        "JUNE_FILES_ROOT": "<YOUR_JUNE_FILES_ROOT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "june-mcp": {
      "command": "uvx",
      "args": [
        "june-mcp"
      ],
      "env": {
        "JUNE_BASE_URL": "<YOUR_JUNE_BASE_URL>",
        "JUNE_CANVAS": "<YOUR_JUNE_CANVAS>",
        "JUNE_API_KEY": "<YOUR_JUNE_API_KEY>",
        "JUNE_LLM_KEY": "<YOUR_JUNE_LLM_KEY>",
        "JUNE_CANVAS_CREATE": "<YOUR_JUNE_CANVAS_CREATE>",
        "JUNE_READONLY": "<YOUR_JUNE_READONLY>",
        "JUNE_FILES_ROOT": "<YOUR_JUNE_FILES_ROOT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "june-mcp": {
      "command": "uvx",
      "args": [
        "june-mcp"
      ],
      "env": {
        "JUNE_BASE_URL": "<YOUR_JUNE_BASE_URL>",
        "JUNE_CANVAS": "<YOUR_JUNE_CANVAS>",
        "JUNE_API_KEY": "<YOUR_JUNE_API_KEY>",
        "JUNE_LLM_KEY": "<YOUR_JUNE_LLM_KEY>",
        "JUNE_CANVAS_CREATE": "<YOUR_JUNE_CANVAS_CREATE>",
        "JUNE_READONLY": "<YOUR_JUNE_READONLY>",
        "JUNE_FILES_ROOT": "<YOUR_JUNE_FILES_ROOT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "june-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "june-mcp"
      ],
      "env": {
        "JUNE_BASE_URL": "<YOUR_JUNE_BASE_URL>",
        "JUNE_CANVAS": "<YOUR_JUNE_CANVAS>",
        "JUNE_API_KEY": "<YOUR_JUNE_API_KEY>",
        "JUNE_LLM_KEY": "<YOUR_JUNE_LLM_KEY>",
        "JUNE_CANVAS_CREATE": "<YOUR_JUNE_CANVAS_CREATE>",
        "JUNE_READONLY": "<YOUR_JUNE_READONLY>",
        "JUNE_FILES_ROOT": "<YOUR_JUNE_FILES_ROOT>"
      }
    }
  }
}

Claude Code

claude mcp add june-mcp --env JUNE_BASE_URL=<YOUR_JUNE_BASE_URL> --env JUNE_CANVAS=<YOUR_JUNE_CANVAS> --env JUNE_API_KEY=<YOUR_JUNE_API_KEY> --env JUNE_LLM_KEY=<YOUR_JUNE_LLM_KEY> --env JUNE_CANVAS_CREATE=<YOUR_JUNE_CANVAS_CREATE> --env JUNE_READONLY=<YOUR_JUNE_READONLY> --env JUNE_FILES_ROOT=<YOUR_JUNE_FILES_ROOT> -- uvx june-mcp