Tana

Tana is an MCP server that connects AI assistants to Tana's Input API to create and manipulate content within Tana workspaces. Built for knowledge workers, project managers, and researchers who rely on Tana for daily operations, this server enables automated entry of structured notes, tasks, and data graphs directly through natural language interactions. Users can invoke twelve discrete tools to build rich-text nodes with custom formatting, generate checkbox-based task lists, add dates or external URLs, and establish hierarchical parent-child structures across multiple levels. It also provides administrative tools for defining new schema components, including custom supertags and field definitions, or assigning metadata values to existing workspace nodes. Because it acts as an interface to the Input API, operations primarily focus on ingestion, sending formatted content to the workspace inbox, library root, or specific node targets without manual copy-pasting.

Category: Notes & Knowledge Management

Tags: knowledge-management, notes, productivity, tana

Visit Tana

How to install and configure Tana

1. Obtain an API token in Tana by navigating to Settings (gear icon) > API tokens > Create new token, and copy the secret. 2. Open your client configuration file, such as claude_desktop_config.json for Claude Desktop. 3. Add the server under the mcpServers object: json { "mcpServers": { "tana-mcp": { "command": "npx", "args": ["-y", "tana-mcp"], "env": { "TANA_API_TOKEN": "your-api-token-here", "TANA_DEFAULT_TARGET": "INBOX" } } } } 4. Alternatively, register it in Claude Code CLI by running claude mcp add -s user -e TANA_API_TOKEN=your-token -e TANA_DEFAULT_TARGET=INBOX tana-mcp npx -y tana-mcp. 5. Restart your MCP client to complete setup.

What you can do with Tana

• Creating structured tasks with due dates, priority tags, and checkbox states directly from conversation summaries into your Tana inbox. - Building nested project outlines that include phases, goals, milestones, and assigned deliverables across complex node hierarchies. - Logging meeting minutes and attendee notes with formatted text, action items, and inline references to existing organizational nodes. - Defining new workspace schema elements, such as generating custom supertags and creating specialized metadata fields on the fly. - Capturing web bookmarks, reading list items, and article links alongside contextual summaries without opening the Tana interface.

Key facts

• https://github.com/tim-mcdonnell/tana-mcp
• Notes & Knowledge Management, Project & Task Management
• knowledge-management, notes, productivity, tana

Part of MCP Servers

How do I install Tana MCP server?

You can install and run the server using npx by specifying tana-mcp in your client configuration. Add your Tana API token to the environment variables under TANA_API_TOKEN, and set an optional target such as INBOX under TANA_DEFAULT_TARGET in Claude Desktop, Raycast, or the Claude Code command line interface.

What can Tana MCP server do?

The server offers twelve tools to create plain, formatted, date, checkbox, URL, and file nodes. It also enables nested hierarchy creation, custom supertag and field definition, assigning field values to nodes, and renaming plain nodes via Tana's Input API.

Can Tana MCP server read existing notes from my workspace?

No, it cannot read or query existing workspace nodes. The server relies on Tana's Input API, which is strictly write-only for sending new data or updates into a workspace.

Which MCP clients work with Tana MCP server?

It is compatible with any client supporting the Model Context Protocol over stdio, including Claude Desktop, Claude Code CLI, and Raycast with the community MCP extension.

Is the Tana MCP server actively maintained?

The original repository is no longer actively maintained by the author, but the project remains available as an open reference implementation on GitHub for developers wishing to fork and extend it.