Worldku Memory MCP server

worldku-mcp

The official MCP server for Worldku memory. Save AI conversations into your Worldku memory and recall them back — from Claude Code, claude.ai, ChatGPT, Codex, Gemini CLI, or any other MCP client.

Full setup guide: worldku.com/docs/mcp — step-by-step instructions for every client, authentication details, and troubleshooting. The same page in raw Markdown for AI agents: worldku.com/docs/mcp.md.

The fastest way to set up: paste this into your AI tool and let it walk you through —

I want to give you long-term memory with Worldku. Read

https://www.worldku.com/docs/mcp.md and walk me through connecting it, in

your own words.

Hosted service. The public endpoint is https://mcp.worldku.com/mcp. This repository is the open access layer only: the memory extraction pipeline, prompt rules, and platform services run on Worldku's infrastructure. Self-hosting this worker will not give you a working service — it exists for transparency and review, and connects to backends that require Worldku credentials.

Tools

All tools fire only on your explicit ask — the tool descriptions instruct the model never to call them from ambient association. Saved transcripts go through Worldku's normal import pipeline: extraction runs asynchronously and new memories land in your memory workbench marked unread. Re-saving the same conversation is deduplicated server-side; extending a previously saved conversation appends only the new tail.

Connecting

Two authentication routes:

server URL and sign in at worldku.com when prompted.

• OAuth 2.1 — claude.ai and ChatGPT need no key at all: point them at the

worldku.com → Memory manager → AI tools. The key is shown once at mint time; up to 20 keys per account, each independently revocable.

• Access key — CLI clients use a wkmcp… key, minted at

Claude Code

claude mcp add --transport http --scope user worldku https://mcp.worldku.com/mcp \
  --header "Authorization: Bearer wk_mcp_YOUR_KEY"

To keep the key out of the config file, export WORLDKUMCPKEY in your shell profile and use single quotes: --header 'Authorization: Bearer ${WORLDKUMCPKEY}'.

claude.ai (web, desktop, mobile)

Settings → Connectors → Add → Add custom connector → https://mcp.worldku.com/mcp → sign in at worldku.com. No key needed.

ChatGPT (web)

Enable Developer mode (Settings → Security and login), then create an app at chatgpt.com/plugins with the server URL and OAuth authentication. Sign in at worldku.com when prompted.

Codex CLI

export WORLDKU_MCP_KEY=wk_mcp_YOUR_KEY
codex mcp add worldku --url https://mcp.worldku.com/mcp --bearer-token-env-var WORLDKU_MCP_KEY

Gemini CLI

// ~/.gemini/settings.json — note the httpUrl field name
{
  "mcpServers": {
    "worldku": {
      "httpUrl": "https://mcp.worldku.com/mcp",
      "headers": { "Authorization": "Bearer wk_mcp_YOUR_KEY" }
    }
  }
}

Any other MCP client

Any client that supports Streamable HTTP with a custom header works:

• URL: https://mcp.worldku.com/mcp
• Header: Authorization: Bearer wkmcpYOUR_KEY

Shortened. The full README is on GitHub.