Bring your own AI.

Oyster is an MCP server. Any AI that speaks the protocol can control your workspace.

Quick start
run in your terminal
claude mcp add --scope user --transport http oyster http://localhost:4444/mcp/
.cursor/mcp.json
{
  "mcpServers": {
    "oyster": {
      "url": "http://localhost:4444/mcp/"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "oyster": {
      "type": "http",
      "url": "http://localhost:4444/mcp/"
    }
  }
}
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "oyster": {
      "serverUrl": "http://localhost:4444/mcp/"
    }
  }
}
What you can do
"Create a deck about Q2 results" → appears on your surface
"Scan ~/Dev/my-project" → new space with apps, docs, and diagrams discovered
"Open the competitor analysis" → opens it in the viewer
"Move the pitch deck to the clients space" → reassigned instantly
"Remember the deadline is Friday" → stored in memory, recalled later
Available tools
get_context list_spaces switch_space onboard_space gather_repo_context list_artifacts create_artifact register_artifact read_artifact update_artifact remove_artifact open_artifact reveal_artifact regenerate_icon remember recall forget list_memories

Your AI can chain these together. Ask it to onboard a project, create a summary, and organise everything into spaces — all from one prompt.

Don't have Oyster yet?
terminal
$ npm install -g oyster-os
$ oyster
no install? try: $ npx oyster-os