MCPgee
MCPgee
MCPgeeMCPgee

Supertag

v1.0.0•Knowledge & Memory•stable

CLI for Tana integration - query, create, sync, and manage Tana workspaces with semantic search and MCP Server

supertag-climcpai-integration
Share:
43
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Supertag?

Supertag is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cli for tana integration - query, create, sync, and manage tana workspaces with semantic search and mcp server

CLI for Tana integration - query, create, sync, and manage Tana workspaces with semantic search and MCP Server

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • CLI for Tana integration - query, create, sync, and manage T

Use Cases

Query, create, and sync Tana workspaces.
Perform semantic search across your knowledge base.
Manage Tana workspaces with AI agents.
jcfischer

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx supertag-cli

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Supertag

Supertag is a CLI and MCP server for Tana, the connected thinking workspace, enabling AI assistants to query, create, edit, and sync Tana nodes through natural language. It provides full-text and semantic search, graph traversal, aggregation, timeline analysis, node creation with fields and supertags, and delta-sync with the Tana Desktop Local API for incremental updates. The separate supertag-mcp binary exposes all these capabilities as MCP tools for Claude, Cursor, ChatGPT, and other MCP clients, making your entire Tana knowledge base accessible from your AI assistant.

Prerequisites

  • macOS, Linux, or Windows operating system
  • A Tana account with an API token (generated at app.tana.inc/app/settings/api)
  • Tana Desktop app installed (required for Local API / delta-sync features)
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
1

Install Supertag

Install the Supertag CLI using the one-liner install script, Homebrew on macOS, or the PowerShell script on Windows.

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/jcfischer/supertag-cli/main/install.sh | bash

# macOS via Homebrew
brew install jcfischer/supertag/supertag

# Windows PowerShell
irm https://raw.githubusercontent.com/jcfischer/supertag-cli/main/install.ps1 | iex
2

Configure your Tana API token

Set your Tana API token so Supertag can authenticate with the Tana API. Generate the token at app.tana.inc under Settings > API.

supertag config --token "your_tana_api_token_here"
3

Export and index your Tana workspace

Run a full export of your Tana workspace and build the local search index. This is required before semantic search and queries will work.

supertag-export login
supertag sync index
4

Add the supertag-mcp server to your MCP client configuration

Edit your MCP client config to add the supertag-mcp server with your Tana token. The TANA_MCP_TOOL_MODE controls how many tools are exposed (full, slim, or lite).

{
  "mcpServers": {
    "supertag": {
      "command": "supertag-mcp",
      "args": [],
      "env": {
        "TANA_API_TOKEN": "YOUR_TANA_API_TOKEN",
        "TANA_LOCAL_API_TOKEN": "YOUR_LOCAL_API_TOKEN",
        "TANA_LOCAL_API_URL": "http://localhost:8262",
        "TANA_MCP_TOOL_MODE": "full",
        "TANA_DELTA_SYNC_INTERVAL": "5"
      }
    }
  }
}
5

Restart your MCP client and test

Restart Claude Desktop or your IDE. Ask your AI assistant to search for something in your Tana workspace to confirm the connection.

Supertag Examples

Client configuration

Example claude_desktop_config.json for Supertag with full tool mode and delta sync enabled.

{
  "mcpServers": {
    "supertag": {
      "command": "supertag-mcp",
      "args": [],
      "env": {
        "TANA_API_TOKEN": "YOUR_TANA_API_TOKEN",
        "TANA_LOCAL_API_TOKEN": "YOUR_LOCAL_API_TOKEN",
        "TANA_LOCAL_API_URL": "http://localhost:8262",
        "TANA_MCP_TOOL_MODE": "full",
        "TANA_DELTA_SYNC_INTERVAL": "5"
      }
    }
  }
}

Prompts to try

Example prompts for querying and managing your Tana knowledge base.

- "Search my Tana workspace for all meeting notes from last week."
- "Find all TODO nodes that have Status set to 'Active' in my Tana workspace."
- "Create a new meeting node in Tana for today's standup with the owner set to me."
- "Show a timeline of tasks grouped by week for the past month."
- "Find all people connected to the 'Q4 Planning' meeting node in Tana."

Troubleshooting Supertag

supertag-mcp command not found after installation

Ensure the install script completed successfully and that ~/.local/bin (or the Homebrew bin path) is in your PATH. Run 'which supertag-mcp' to verify. On macOS, restart your terminal after installation.

Semantic search returns no results or stale data

Run 'supertag sync index' to rebuild the search index from your latest Tana export. If you have delta sync enabled, ensure Tana Desktop is running and TANA_DELTA_SYNC_INTERVAL is set to a non-zero value.

Local API calls fail with connection refused

Tana Desktop must be running with the Local API enabled for TANA_LOCAL_API_TOKEN and TANA_LOCAL_API_URL to work. Open Tana Desktop, go to Settings, and enable the Local API. The default port is 8262.

Frequently Asked Questions about Supertag

What is Supertag?

Supertag is a Model Context Protocol (MCP) server that cli for tana integration - query, create, sync, and manage tana workspaces with semantic search and mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Supertag?

Follow the installation instructions on the Supertag GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Supertag?

Supertag works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Supertag free to use?

Yes, Supertag is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Supertag Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Supertag? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "supertag-cli": { "command": "npx", "args": ["-y", "supertag-cli"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Supertag?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides