Tana

[!IMPORTANT] This project is no longer actively maintained. I've moved on from Tana and no longer use the software, so I'm not in a position to keep this MCP server current or provide ongoing support. The repository remains available as a reference, and anyone who finds it useful is encouraged to fork it and continue development.

AModel Context Protocol (MCP)server that connects toTana's Input API, enabling AI assistants to create and manipulate data in your Tana workspace.

- Features
- Prerequisites
- Getting Your Tana API Token
- Installation

- Raycast
- Claude Code (CLI)
- Claude Desktop
- Other MCP Clients

- Available Tools
- Example Prompts
- Text Formatting

- ATanaworkspace with API access enabled
- Tana API token (seeGetting Your Tana API Token)
- One of the following MCP clients:

- Raycastwith AI features
- Claude CodeCLI
- Claude Desktop
- Any other MCP-compatible client
- OpenTanain your browser
- Click on theSettingsicon (gear) in the bottom left
- Navigate toAPI tokens
- ClickCreate new token
- Give it a descriptive name (e.g., "MCP Server")
- Copy the token immediately - it won't be shown again

Raycast integrates MCP servers directly into its AI features. Once configured, use@tana-mcpin any Raycast AI interaction.
- Open Raycast
- Search for "Store" and open the Raycast Store
- Search for "Model Context Protocol"
- Install theMCP extension
- Open Raycast and search for"Install Server"(from the MCP extension)
- Fill in the form:
- Add environment variables:

- TANA_API_TOKEN: Your Tana API token
- TANA_DEFAULT_TARGET:INBOX(optional - seeConfiguration Options)

{ "name": "Tana", "type": "stdio", "command": "npx", "args": ["-y", "tana-mcp"], "env": { "TANA_API_TOKEN": "your-api-token-here", "TANA_DEFAULT_TARGET": "INBOX" } }

Once installed, mention the server in any Raycast AI interaction:

- Quick AI: Type your query and mention@Tana
- AI Chat: Start a chat and use@Tanato invoke tools
- AI Commands: Create custom commands that use Tana tools

Example:"@Tana Create a task called 'Review quarterly report' with high priority"

For more details, see theRaycast MCP documentation.

claude mcp add -s user \ -e TANA_API_TOKEN=your-api-token-here \ -e TANA_DEFAULT_TARGET=INBOX \ tana-mcp \ npx -y tana-mcp

claude mcp add \ -e TANA_API_TOKEN=your-api-token-here \ tana-mcp \ npx -y tana-mcp

{ "mcpServers": { "tana-mcp": { "command": "npx", "args": ["-y", "tana-mcp"], "env": { "TANA_API_TOKEN": "your-api-token-here", "TANA_DEFAULT_TARGET": "INBOX" } } } }

For any MCP-compatible client, configure with:

Or if installed globally (npm install -g tana-mcp):

- OmitTANA_DEFAULT_TARGET: Nodes appear in Library root
- INBOX: Nodes go to your Tana Inbox for later processing
- Any node ID: Nodes created under that specific node

Create a node called "Meeting Notes - January 9th"

Create a task "Review PR #123" that's not yet completed

Create a formatted node with bold text and a reference to node ID abc123

Create a project structure with: - Project: Website Redesign - Phase 1: Research - Phase 2: Design - Phase 3: Development

Create a new supertag called "Book" for tracking my reading list

Here are natural language prompts that work well:

Thecreate_formatted_nodetool supports rich text formatting in node names:

- Inline node references: Link to other nodes by ID
- Inline dates: Clickable date links

Create a formatted node: "Discussed important changes with [PERSON] on [DATE]" with PERSON referencing node xyz123 and DATE as 2024-01-15

These are Tana Input API limitations, not server limitations:

- Reading/querying existing nodes (write-only API)
- Targeting "Today" or relative date nodes
- Updating checkbox/boolean nodes
- Non-HTTP/HTTPS links

git clone https://github.com/tim-mcdonnell/tana-mcp.git cd tana-mcp bun install # or: npm install bun run build # or: npm run build

claude mcp add -s user \ -e TANA_API_TOKEN=your-token \ tana-mcp-dev \ bun /path/to/tana-mcp/dist/index.js

"Missing expected parameter key: items"

This error occurred in versions before 2.0.0. Update to the latest version:
- Verify your token: Make sureTANA_API_TOKENis set correctly
- Check the command: Ensurenpxis available in your PATH
- Restart the client: Some clients require restart after config changes
- Check logs: Look for error messages in your MCP client's logs

- SetTANA_DEFAULT_TARGET=INBOXto use your inbox
- Or specifytargetNodeIdin individual tool calls

This happens when trying to rename checkbox/boolean nodes. The Tana API only supports renaming plain text nodes.

The Tana API limits requests to 1 per second. If you're hitting rate limits, slow down your requests or batch operations together.

Contributions welcome! Please feel free to submit a Pull Request.

MIT License - seeLICENSEfile for details.

- Issues:GitHub Issues
- Tana API Docs:tana.inc/docs/input-api
- MCP Protocol:modelcontextprotocol.io

- Raycast MCP Documentation
- Raycast MCP Extension
- Tana Input API

Interact with markdown notes in a personal knowledge vault, such as Obsidian.