Provides a runtime environment for the Tana MCP server, which connects to Tana's Input API to create and manipulate nodes, fields, and schemas in Tana workspaces.
Enables adding the Tana MCP server to Raycast, allowing users to create and manipulate data in Tana workspaces through Raycast's MCP extension.
Tana MCP Server
A Model Context Protocol (MCP) server that connects to Tana's Input API, allowing Large Language Models (LLMs) and other MCP clients to create and manipulate data in Tana workspaces.
Features
This MCP server provides comprehensive access to Tana's Input API with:
🛠️ Tools (11 available)
- Node Creation: Create plain, reference, date, URL, checkbox, and file nodes
- Field Management: Create and manage field nodes with structured data
- Complex Structures: Build nested node hierarchies
- Schema Operations: Create supertags and field definitions
- Node Updates: Modify existing node names
💬 Prompts (4 templates)
- Task Creation: Structured task creation with due dates and priorities
- Project Setup: Complete project structures with goals and milestones
- Meeting Notes: Formatted meeting notes with attendees and action items
- Knowledge Base: Organized knowledge entries with categories and sources
📚 Resources (4 available)
- API Documentation: Complete reference for Tana Input API
- Node Types Guide: Detailed examples of all supported node types
- Usage Examples: Common patterns and best practices
- Server Info: Current status and configuration details
Requirements
- Node.js 18 or higher
- A Tana workspace with API access enabled
- Tana API token (generated from Tana settings)
Installation
Global Installation (Recommended)
Local Installation
Configuration
Claude Desktop
Add this to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Raycast
- Install the MCP extension in Raycast
- Open "Manage MCP Servers" command
- Add a new server with this configuration:
Other MCP Clients
For other MCP-compatible clients, use:
- Command:
npx -y tana-mcp
(ortana-mcp
if installed globally) - Environment:
TANA_API_TOKEN=your-api-token-here
Getting Your Tana API Token
- Open Tana in your browser
- Go to Settings → API tokens
- Create a new token with appropriate permissions
- Copy the token and add it to your MCP client configuration
Usage Examples
Once configured, you can interact with Tana through your MCP client:
Creating a Simple Node
Creating a Task
Creating a Project Structure
Using Prompts
MCP clients that support prompts can use templates like:
create-task
- Interactive task creationcreate-project
- Structured project setupcreate-meeting-notes
- Meeting documentationcreate-knowledge-entry
- Knowledge base entries
API Limitations
- Maximum 100 nodes per request
- Rate limit: 1 request per second per token
- Payload size: 5000 characters maximum
- Workspace limit: 750,000 nodes
Development
Building from Source
Running in Development
Troubleshooting
"Missing expected parameter key: items" (Raycast)
This error was fixed in v1.2.0. Please update to the latest version.
Connection Issues
- Verify your API token is correct
- Check that your workspace hasn't exceeded the 750k node limit
- Ensure you're not exceeding the rate limit (1 request/second)
Node Creation Failures
- Verify the target node ID exists (if specified)
- Check that supertag/field IDs are valid for your workspace
- Ensure payload is under 5000 characters
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see LICENSE file for details
Support
For issues and feature requests, please use the GitHub Issues page.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that connects to Tana's Input API, allowing Large Language Models and other MCP clients to create and manipulate data in Tana workspaces.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides tools for interacting with Supabase databases, storage, and edge functions.Last updated -1443JavaScriptMIT License
- -securityFlicense-qualityThis is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.Last updated -Python
- -securityAlicense-qualityA simple MCP server implementation that provides AI models with basic Solana RPC methods and helpful development prompts.Last updated -35TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks.Last updated -36512TypeScriptMIT License