Timeln MCP ·

Your memory, wired into any AI agent.

One MCP. Claude Code, Cursor, other agentic IDEs, Claude Desktop, and anything else that speaks MCP—read and write your Timeln.

One-liner for Claude Code

claude mcp add --transport http --scope user timeln \
  https://timeln-mcp-production.up.railway.app/mcp \
  --header "Authorization: Bearer tln_YOUR_TOKEN"
Grab a free token Read the launch →
claude-code

Drop-in

Works everywhere MCP works.

Claude Code, Cursor, and other agentic IDEs, plus Claude Desktop, Zed, and Windsurf—if it speaks Model Context Protocol, it speaks Timeln. No plugins, no adapters. Paste one JSON block and your agent gains memory.

/mcp → timeln ✓ connected
cursor

Zero-trust

Your token, your data.

Every request forwards a bearer token you created. Revoke it from Settings → API keys and the connection dies instantly. No shared secrets, no service accounts, no surprises.

Authorization: Bearer tln_...
timeln.app/settings

8 tools

A real API, not a demo.

Read your graph, ask questions, add new content. All from the chat.

  • whoami
  • query_knowledge
  • get_recent_docs
  • search_documents
  • get_document
  • get_topic_entities
  • ingest_text
  • ingest_url
query_knowledge("my open threads on GTM?")
timeln-mcp

Hosted

Zero install. Zero ops.

We run the MCP, behind TLS, regionally redundant. No Python, no Docker, no keeping a daemon alive.

server

Setup

Connect Timeln to Claude.

The Timeln MCP server lives at https://timeln-mcp-production.up.railway.app/mcp. You authenticate with a bearer token (starts with tln_) from Settings → API keys in Timeln. Pick your client below.

Claude Code (CLI)

Native remote HTTP MCP — one command, no wrapper.

claude mcp add --transport http --scope user timeln \
  https://timeln-mcp-production.up.railway.app/mcp \
  --header "Authorization: Bearer tln_YOUR_TOKEN"

Verify with claude mcp list — you should see timeln · ✓ Connected. Use --scope project to share via .mcp.json, or --scope local for the current directory only.

Claude Desktop (Mac / Windows)

Desktop only speaks stdio MCP, so the remote endpoint is wrapped with mcp-remote. Requires Node.js 18+.

Open your config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "timeln": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://timeln-mcp-production.up.railway.app/mcp",
        "--header",
        "Authorization: Bearer tln_YOUR_TOKEN"
      ]
    }
  }
}

Fully quit (Cmd+Q on Mac, not just close) and reopen. First launch takes 10–20 s while npx fetches mcp-remote. Confirm under Settings → Developer → Local MCP servers.

claude.ai (web)

Custom Connector. Requires a Pro, Max, Team, or Enterprise plan.

  1. Open Settings → Connectors, click Add custom connector.
  2. Name: Timeln
  3. Remote MCP server URL: https://timeln-mcp-production.up.railway.app/mcp
  4. Authentication: Bearer token — paste your tln_… token.
  5. Save, then enable it in any chat from the Search & tools menu.

Troubleshooting (Claude Desktop)

SymptomFix
Cannot find module './lib/dispatcher/client' or TAR_ENTRY_ERROR in logsCorrupted npx cache. rm -rf ~/.npm/_npx and restart Claude.
"Not a valid MCP server configuration" on launchYou used the "type": "http" / "url" syntax. That's Claude Code's format — Desktop needs the command + args form above.
command not found: npxInstall Node.js, then restart Claude so it picks up the new PATH.
Multiple accountsAdd a second entry with a different key name (e.g. timeln-personal) using that account's token.

Logs live at ~/Library/Logs/Claude/mcp-server-timeln.log on macOS — tail -f is your friend.

Security

Your bearer token grants full access to your Timeln data. Treat it like a password.

  • Never commit it to a repo or paste it into a public chat.
  • Rotate it from Timeln Settings → API keys if it leaks.
  • Use a separate token per device/client so you can revoke individually.

Go deeper

Want the full second-brain skill on top?

The open-source Second Brain skill layers reasoning on top of the MCP.

See the skill

Frequently asked

Yes. The MCP is a bridge to your Timeln library — no account, no data to bridge. Free forever tier is enough to get started.

Ready when you are.

Free forever. No credit card. 30 seconds from signup to a working agent.

Get a free Timeln account View on GitHub