Tana Codemode

Codemode MCP server for Tana. AI writes TypeScript that executes directly against the Tana Local API.

Requires: Tana Desktop with Local API enabled + an API token (Settings → API).

Install

Binary — download from GitHub Releases, chmod +x, run.

npm (Node.js ≥ 20):

npm install -g tana-mcp-codemode

From source (Bun): git clone → bun install → bun run src/entry-bun.ts

Setup

Run the interactive setup script — detects your installation, prompts for credentials, and configures Claude Code and/or Claude Desktop automatically:

bun run setup
# or for team-shared config:
bun run setup --scope project

Manual MCP Configuration

{
  "mcpServers": {
    "tana": {
      "command": "tana-mcp-codemode",
      "env": {
        "TANA_API_TOKEN": "your-token-here",
        "MAIN_TANA_WORKSPACE": "My Workspace"
      }
    }
  }
}

For binary: set command to the binary path. For source: "command": "bun", "args": ["run", "/path/to/src/entry-bun.ts"].

Environment Variables

Usage Examples

// Search nodes
const results = await tana.nodes.search("project ideas", {
  workspaceIds: [tana.workspace.id]
});

// Import with tags and fields
await tana.import(tana.workspace.id, `
%%tana%%
- Meeting notes #meeting
  - Date:: [[2024-01-15]]
  - Attendees:: Alice, Bob
`);

API Reference

Development

bun run start        # MCP server
bun run dev          # watch mode
bun run test         # tests
bun run build        # Node.js dist (tsup)
bun run build:binary # self-contained binary
bun run debug        # debug UI at :3333

License

MIT