What can you do with TimeBase?

TimeBase MCP

A Model Context Protocol server that lets a coding agent (Claude Code, VS Code, Cursor, Claude Desktop, etc.) explore and query TimeBase: list streams, read schemas and symbols, preview messages, run QQL queries, and inspect server status and activity.

The server can run two ways:

Locally, your agent launches timebase-mcp as a local process (stdio) that connects to your TimeBase.
Remotely, you deploy timebase-mcp as a shared HTTP service that multiple users connect their agents to.

Which guide do I need?

You want to	Go to
Use TimeBase MCP locally (Cursor, VS Code, Claude Code/Desktop)	Agent Plugins Quickstart
Manual local setup	Local setup
Deploy a shared remote MCP server	Remote deployment
Connect to a running remote server	Connect to a remote server

Documentation

Topic	Go to
Updating	Local setup: Updating
Troubleshooting	Troubleshooting
Reference	Environment variables, auth, capabilities

Install

Add TimeBase to your client. Pick the one you use.

claude mcp add timebase-mcp -- uvx timebase-mcp

codex mcp add timebase-mcp -- uvx timebase-mcp

amp mcp add timebase-mcp -- uvx timebase-mcp

{
  "mcpServers": {
    "timebase-mcp": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "timebase-mcp": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"timebase-mcp","command":"uvx","args":["timebase-mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "timebase-mcp": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "timebase-mcp": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "timebase-mcp": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "timebase-mcp": {
      "type": "local",
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "timebase-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "timebase-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

uvx timebase-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation13/25
Maintenance25/25
Trust16/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 1 days ago
Has a release history
Repository is not archived
Licensed Apache-2.0
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.2.3Latest	Aug 31, 2026
0.2.2	Aug 5, 2026
0.2.1	Jul 28, 2026