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